Can I use… width_bucket()

Apache DerbyBigQueryDb2 (LUW)H2MariaDBMySQLOracle DBPostgreSQLSQL ServerSQLite20072009201120132015201720192021⊘ 3.5.7 - 3.42.0⊘ 2008R2 - 2022✓ 8.4+⊘ 8.3✓ 11gR1+⊘ 5.0 - 8.0.33⊘ 5.1 - 10.11⊘ 1.4.191 - 2.1.214✓ 11.1+⊘ 9.7 - 10.5⊘ 2.0⊘ -

The width_bucket() function distributes rows into n groups where each represents a equal-width value range between a specified minimum and maximum.

SELECT width_bucket(x, 0, 1, 10) -- (input, min, max, n)
  FROM …

The example returns an integer between from 0 to 11 by splitting the range 0 to 1 (min to max) into 10 equal parts (n). If x falls into the range 0 to 1 it returns the group into which x belongs. 0 or 11 are returned if x is outside the range (below minimum or above maximum).

Normative References

The width_bucket() window function is defined in ISO/IEC 9075:2016-2 as part of optional feature T612, “Advanced 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-⁠ on your radar.

About the Author

Photo of Markus Winand

Markus Winand provides insights into SQL and shows how different systems support it at Previously he made, which is still actively maintained. Markus can be hired as trainer, speaker and consultant via

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

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