Available in versions: Dev (3.19) | Latest (3.18) | 3.17 | 3.16 | 3.15 | 3.14 | 3.13 | 3.12 | 3.11 | 3.10 | 3.9
NTH_VALUE
Applies to ✅ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition
The NTH_VALUE window function allows for getting the value of an expression evaluated on the Nth row of the window.
SELECT ID, nth_value(ID, 2) OVER (ORDER BY ID), nth_value(ID, 2) OVER (ORDER BY ID ROWS 2 PRECEDING) FROM BOOK;
create.select(
BOOK.ID,
nthValue(BOOK.ID, 2).over(orderBy(BOOK.ID)),
nthValue(BOOK.ID, 2).over(orderBy(BOOK.ID).rowsPreceding(2)))
.from(BOOK)
.fetch();
Producing:
+----+-----------+-----------+ | id | nth_value | nth_value | +----+-----------+-----------+ | 1 | | | | 2 | 2 | 2 | | 3 | 2 | 2 | | 4 | 2 | 3 | +----+-----------+-----------+
- The window frame clause is applied to
NTH_VALUE. -
NTH_VALUEsupports the optional NULL treatment clause. -
NTH_VALUEsupports the optional FIRST / LAST clause.
Dialect support
This example using jOOQ:
nthValue(BOOK.ID, 2).over(orderBy(BOOK.ID))
Translates to the following dialect specific expressions:
-- AURORA_POSTGRES, BIGQUERY, COCKROACHDB, DB2, DUCKDB, EXASOL, FIREBIRD, H2, HANA, MARIADB, MEMSQL, MYSQL, ORACLE, -- POSTGRES, SNOWFLAKE, SQLITE, TRINO, VERTICA, YUGABYTEDB nth_value(BOOK.ID, 2) OVER (ORDER BY BOOK.ID) -- ACCESS, ASE, AURORA_MYSQL, DERBY, HSQLDB, INFORMIX, REDSHIFT, SQLDATAWAREHOUSE, SQLSERVER, SYBASE, TERADATA /* UNSUPPORTED */
(These are currently generated with jOOQ 3.19, see #10141), or translate your own on our website
Feedback
Do you have any feedback about this page? We'd love to hear it!