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⊘ 10.15.1.3 - 10.16.1.1

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-⁠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