over(… range between …) (numeric)


Apache DerbyBigQueryDb2 (LUW)H2MariaDBMySQLOracle DBPostgreSQLSQL ServerSQLite20072009201120132015201720192021✓ 3.28.0 - 3.43.0a⚠ 3.25.0 - 3.26.0a⊘ 3.5.7 - 3.23.1⚠ 2012 - 2022a⊘ 2008R2✓ 11 - 16a⚠ 8.4 - 10a⊘ 8.3✓ 11gR1 - 21c✓ 8.0.11 - 8.0.34⊘ 5.0 - 5.7✓ 10.2 - 10.11⊘ 5.1 - 10.1✓ 1.4.198 - 2.2.220⊘ 1.4.191 - 1.4.197✓ 9.7 - 11.5.8✓ 2.0⊘ 10.15.1.3 - 10.16.1.1
  1. Only with unbounded and current row — not with interval distance as shown below

The over accepts range framing, which limits the scope of the window functions to the rows between the specified range of values relative to the value of the current row.

SELECT *, COUNT(*) OVER(ORDER BY val
                        RANGE BETWEEN 1 PRECEDING
                                  AND CURRENT ROW)
  FROM …

Returns an additional column with the row count of the rows that have the order by value up to 1 less than the current row (1 preceding) and all rows that hat the same order by value as the current row (current row).

ORDER BY valRANGEBETWEEN 1 PRECEDINGrange betwAND CURRENT ROWval55.5667current row

Meaningful framing requires an order by clause in over as well. Note that this order by clause does not necessarily affect the order of rows in the final result. If you want the result in a specific order, add an order by clause at the outermost query level.

Normative References

The over clause, including range between, is defined in ISO/IEC 9075-2:2023 as part of optional feature T611, “Elementary OLAP operations”.

You can’t catch up on 20 years of SQL evolution in one day. Subscribe the newsletter via E-Mail, Twitter or RSS to gradually catch up and to keep modern-⁠sql.com on your radar.

About the Author

Photo of Markus Winand

Markus Winand provides insights into SQL and shows how different systems support it at modern-sql.com. Previously he made use-the-index-luke.com, which is still actively maintained. Markus can be hired as trainer, speaker and consultant via winand.at.

Buy the Book

Cover of “SQL Performance Explained”: Squirrel running on grass

The essence of SQL tuning in 200 pages

Buy now!
(paperback and/or PDF)

Paperback also available at Amazon.com.

Hire Markus

Markus offers SQL training and consulting for developers working at companies of all sizes.
Learn more »

Connect with Markus Winand

Markus Winand on LinkedInMarkus Winand on XINGMarkus Winand on Twitter
“modern SQL” by Markus Winand is licensed under a Creative Commons Attribution-Noncommercial-No Derivative Works 3.0 Unported License.
Legal | Contact | NO WARRANTY | Trademarks | Privacy and GDPR | CC-BY-NC-ND 3.0 license