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

  • Статья

Область применения:проверка помечено да Databricks SQL проверка помечено да Databricks Runtime

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

Синтаксис

first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]

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

Аргументы

  • expr: выражение любого типа.
  • ignoreNull: необязательный литерал BOOLEAN, по умолчанию — false.
  • cond: необязательное логическое выражение, фильтрующее строки, используемые для агрегирования.
  • IGNORE NULLS или RESPECT NULLS: если IGNORE NULLS используется или ignoreNull является true любым 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