Агрегатная функция first_value

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

Возвращает первое значение expr для группы строк. Эта функция является синонимом first агрегатной функции.

Синтаксис

first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ] [ IGNORE NULLS | RESPECT NULLS ]

Эту функцию можно также вызвать как функцию окна с помощью OVER предложения.

Аргументы

• expr: выражение любого типа.
• ignoreNull: необязательный BOOLEAN литерал, который по умолчанию равен false.
• cond: необязательное логическое выражение, фильтрующее строки, используемые для агрегирования.
• IGNORE NULLS или RESPECT NULLS: при использовании IGNORE NULLS или установке ignoreNulltrueфункции игнорируется любое expr значение, равное NULL. Значение по умолчанию — RESPECT NULLS.

Возвраты

Результат относится к тому же типу, что и expr.

Эта функция является недетерминированной.

Примеры

> SELECT first_value(col) FROM VALUES (10), (5), (20) AS tab(col);
 10

> SELECT first_value(col) FROM VALUES (NULL), (5), (20) AS tab(col);
 NULL

> SELECT first_value(col, true) FROM VALUES (NULL), (5), (20) AS tab(col);
 5

> SELECT first_value(col) IGNORE NULLS FROM VALUES (10), (5), (NULL) AS tab(col);
 10

> SELECT first_value(col) FILTER (WHERE col > 5) FROM VALUES (5), (20) AS tab(col);
 20

Связанные

• min агрегатная функция
• max агрегатная функция
• last агрегатная функция
• last_value агрегатная функция
• first агрегатная функция
• Функции окна