функция окна аналитики nth_value

Область применения: Databricks SQL Databricks Runtime

Возвращает значение по заданному offset в окне.

Синтаксис

nth_value(expr, offset) [ IGNORE NULLS | RESPECT NULLS ] OVER clause

Аргументы

• expr: выражение любого типа.
• offset: литерал целого числа больше 0.
• IGNORE NULLS или RESPECT NULLS: когда используется IGNORE NULLS, любое значение expr, равное NULL, не учитывается. Значение по умолчанию — RESPECT NULLS.
• Предложение OVER: предложение, описывающее окно. См. функции окна.

Возвраты

Тип результата соответствует типу expr.

Функция окна возвращает значение expr в строке, которая является offsetстрокой с начала рамки окна.

Если offset-й строки не существует, возвращается значение NULL.

Необходимо использовать условие ORDER BY с этой функцией. Если порядок не уникален, результат будет недетерминированным.

Примеры

> SELECT a, b, nth_value(b, 2) OVER (PARTITION BY a ORDER BY b)
    FROM VALUES ('A1', 2), ('A1', 1), ('A2', 3), ('A1', 1) tab(a, b);
 A1 1   1
 A1 1   1
 A1 2   1
 A2 3   NULL

Связанные функции

• аналитическая оконная функция lag
• аналитическая оконная функция lead
• first агрегатная функция
• last агрегатная функция
• оконные функции