width_bucket()


BigQueryDb2 (LUW)DerbyH2MariaDBMySQLOracle DBPostgreSQLSQL ServerSQLite200720092011201320152017201920212023⊘ 3.5.7 - 3.50.0⊘ 2008R2 - 2022✓ 8.4 - 17⊘ 8.3✓ 11gR1 - 23.9⊘ 5.0 - 9.3.0⊘ 5.1 - 12.0.2⊘ 1.4.191 - 2.3.232⊘ 10.15.1.3 - 10.17.1.0✓ 11.1 - 12.1.2⊘ 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-2:2023 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, Bluesky 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

Subscribe mailinglistsSubscribe the RSS feedMarkus Winand on LinkedInMarkus Winand on XINGMarkus Winand on TwitterMarkus Winand on Bluesky
Copyright 2015-2025 Markus Winand. All righs reserved.
Legal | Contact | NO WARRANTY | Trademarks | Privacy and GDPR