first
агрегатная функция
Область применения: Databricks SQL Databricks Runtime
Возвращает первое значение для expr
группы строк. Эта функция является синонимом агрегатной функции first_value.
Синтаксис
first(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(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