Can I use… qualify clause (window functions)


Apache DerbyBigQueryDb2 (LUW)H2MariaDBMySQLOracle DBPostgreSQLSQL ServerSQLite200520072009201120132015201720192021⊘ 3.25.0 - 3.39.0⊘ 2008R2 - 2019⊘ 8.4 - 14⊘ 11gR1 - 21c⊘ 8.0.11 - 8.0.30⊘ 10.2 - 10.8✓ 1.4.199+⊘ 9.7 - 11.5.7✓ 2.0+⊘ 2.0

Neither the where nor the having clause allow window functions—but the qualify clause does.

 SELECT *
   FROM …
QUALIFY ROW_NUMBER() OVER(PARTITION BY … ORDER BY …) <= 3

The example is a top-n per group query: it returns the first three rows for each partition.

A better supported query to get the same result pushes the window function into the select clause of a sub-query and uses the where clause in the outer query for filtering.

SELECT *
  FROM (SELECT *
             , ROW_NUMBER() OVER(PARTITION BY … ORDER BY …) AS rn
          FROM …
       ) AS sq
 WHERE sq.rn <= 3

Note that this query returns the extra column “rn”.

Normative References

The qualify clause is not defined in the SQL standard ISO/IEC 9075:2016-2.

About the Author

Photo of Markus Winand

Markus Winand is the SQL Renaissance Ambassador. He is on a mission to introduce developers to the evolution of SQL in the 21st century. Markus can be hired as trainer, speaker and consultant via winand.at.

Buy his Book

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

The essence of SQL tuning in 200 pages

Buy now!
(paperback and/or PDF)
Use discount: Summer22

Paperback also available at Amazon.com.

Hire Markus

Markus offers SQL training and consulting for developers working at companies of any size.
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