类别：

:doc:`/sql-reference/functions-window-syntax`（排名）

NTH_VALUE

返回一组有序值中的第 n 个值（不超过 1000）。

另请参阅：

FIRST_VALUE、LAST_VALUE

语法

NTH_VALUE( <expr> , <n> ) [ FROM { FIRST | LAST } ] [ { IGNORE | RESPECT } NULLS ]
  OVER ( [ PARTITION BY <expr1> ] ORDER BY <expr2> [ { ASC | DESC } ] [ NULLS { FIRST | LAST } ] [ <window_frame> ] )
Copy

有关 window_frame 语法的详细信息，请参阅 窗口函数的语法和用法。

实参

n

此示例指定在查找第 N 个值时要使用的 N 值。

expr

确定返回值的表达式。

expr1

用于对行进行分区的表达式。您可以指定单个表达式或以逗号分隔的表达式列表。例如：

PARTITION BY column_1, column_2
Copy
expr2

用于对行进行排序的表达式。您可以指定单个表达式或以逗号分隔的表达式列表。例如：

ORDER BY column_3, column_4
Copy
FROM { FIRST | LAST }

当 expr 包含 NULL 值时，是忽略还是遵照 NULL 值：

  • FROM FIRST 从有序列表的开头开始，并向前移动。

  • FROM LAST 从有序列表的末尾开始，并向后移动。

默认值：FROM FIRST

{ IGNORE | RESPECT } NULLS

当 expr 包含 NULL 值时，是忽略还是遵照 NULL 值：

  • IGNORE NULLS 跳过表达式中的 NULL 值。

  • 如果它是表达式中的第 n 个值，则 RESPECT NULLS 返回 NULL 值。

默认值：RESPECT NULLS

使用说明

  • 输入值 n 不能大于 1000。

  • 此函数是与排名相关的函数，因此它必须指定一个窗口。窗口子句由以下分子句组成：

    • PARTITION BY expr1 分子句（可选）。

    • ORDER BY expr2 分子句（必需）。有关其他受支持的排序选项（排序顺序、NULL 值排序等）的详细信息，请参阅 ORDER BY 子句的文档，该子句遵循相同的规则。

    • window_frame 分子句（可选）。

  • 仅当 ORDER BY 子句中的键使每一行都唯一时，窗口中行的顺序（以及查询结果）才是完全确定的。请参考以下示例：

    ... OVER (PARTITION BY p ORDER BY o COLLATE 'lower') ...
    Copy

    如果任何分区包含相同的列 o 值，或者在不区分大小写的比较中相同，则查询结果可能会有所不同。

  • OVER 子句中的 ORDER BY 子句只控制窗口中行的顺序，而不控制整个查询输出中行的顺序。若要控制输出顺序，请在查询的最外层使用单独的 ORDER BY 子句。

  • 可选的 window_frame`（累积或滑动）指定计算函数的窗口中行的子集。如果未指定 :samp:`window_frame，默认为整个窗口：

    ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING

    请注意，这偏离了 ANSI 标准，该标准为窗口框架指定了以下默认值：

    RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW

有关窗口框架的更多信息（包括语法、使用说明和示例），请参阅 窗口函数的语法和用法。

示例

SELECT column1,
       column2,
       NTH_VALUE(column2, 2) OVER (PARTITION BY column1 ORDER BY column2) AS column2_2nd
  FROM VALUES
    (1, 10), (1, 11), (1, 12),
    (2, 20), (2, 21), (2, 22);
Copy
+---------+---------+-------------+
| COLUMN1 | COLUMN2 | COLUMN2_2ND |
|---------+---------+-------------|
|       1 |      10 |          11 |
|       1 |      11 |          11 |
|       1 |      12 |          11 |
|       2 |      20 |          21 |
|       2 |      21 |          21 |
|       2 |      22 |          21 |
+---------+---------+-------------+

以下示例返回三个相关函数的结果：FIRST_VALUE、NTH_VALUE 和 LAST_VALUE。

  • 该查询创建一个三行宽的滑动窗口框架，其中包含：

    • 当前行前面的行。

    • 当前行。

    • 当前行后面的行。

  • The 2 in the call NTH_VALUE(menu_price_usd, 2) specifies the second row in the window frame (which, in this case, is also the current row).

  • 当前行是窗口框架中的第一行时，没有前面的行可以引用，因此 FIRST_VALUE 为该行返回 NULL。

  • 框架边界有时会超出分区中的行，但不存在的行不包括在窗口函数计算中。例如，若当前行是分区中的第一行而窗口框架 ROWS BETWEEN 1 PRECEDING AND 1 FOLLOWING，没有前一行可供引用，则 FIRST_VALUE 函数返回分区中第一行的值。

  • 鉴于表中的数据，所有三个函数的结果永远不匹配。这些函数为框架中的每行选择 第一个、最后一个 或 第 n 个 值，并且值的选择分别适用于每个分区。

SELECT menu_category, menu_item_name, menu_price_usd,
       FIRST_VALUE(menu_price_usd) OVER (PARTITION BY menu_category ORDER BY menu_price_usd
         ROWS BETWEEN 1 PRECEDING AND 1 FOLLOWING) AS first_val,
       NTH_VALUE(menu_price_usd, 2) OVER (PARTITION BY menu_category ORDER BY menu_price_usd
         ROWS BETWEEN 1 PRECEDING AND 1 FOLLOWING) AS nth_val,
       LAST_VALUE(menu_price_usd) OVER (PARTITION BY menu_category ORDER BY menu_price_usd
         ROWS BETWEEN 1 PRECEDING AND 1 FOLLOWING) AS last_val
  FROM menu_items
  WHERE menu_category = 'Dessert'
  ORDER BY menu_price_usd;
Copy
+---------------+--------------------+----------------+-----------+---------+----------+
| MENU_CATEGORY | MENU_ITEM_NAME     | MENU_PRICE_USD | FIRST_VAL | NTH_VAL | LAST_VAL |
|---------------+--------------------+----------------+-----------+---------+----------|
| Dessert       | Popsicle           |           3.00 |      3.00 |    4.00 |     4.00 |
| Dessert       | Ice Cream Sandwich |           4.00 |      3.00 |    4.00 |     5.00 |
| Dessert       | Mango Sticky Rice  |           5.00 |      4.00 |    5.00 |     6.00 |
| Dessert       | Sugar Cone         |           6.00 |      6.00 |    6.00 |     7.00 |
| Dessert       | Waffle Cone        |           6.00 |      5.00 |    6.00 |     6.00 |
| Dessert       | Two Scoop Bowl     |           7.00 |      6.00 |    7.00 |     7.00 |
+---------------+--------------------+----------------+-----------+---------+----------+