Агрегатная функция first
Область применения: Databricks SQL Databricks Runtime
Возвращает первое значение expr
для группы строк. Эта функция является синонимом first_value агрегатной функции.
Синтаксис
first(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]
Эту функцию также можно вызвать как функцию окна с помощью OVER
предложения.
Аргументы
expr
: выражение любого типа.ignoreNull
: необязательный логический литерал по умолчанию имеет значение false.cond
: необязательное логическое выражение для фильтрации строк, используемых для агрегирования.IGNORE NULLS
илиRESPECT NULLS
: если используетсяIGNORE NULLS
илиignoreNull
имеет значениеtrue
, игнорируются любые значенияexpr
, равные NULL. Значение по умолчанию —RESPECT NULLS
.
Возвраты
Результат относится к тому же типу, что и expr
.
Эта функция является недетерминированной.
Примеры
> SELECT first(col) FROM VALUES (10), (5), (20) AS tab(col);
10
> SELECT first(col) FROM VALUES (NULL), (5), (20) AS tab(col);
NULL
> SELECT first(col, true) FROM VALUES (NULL), (5), (20) AS tab(col);
5