first
funkcja agregacji
Dotyczy: Databricks SQL Databricks Runtime
Zwraca pierwszą wartość expr
dla grupy wierszy. Ta funkcja jest synonimem first_value funkcji agregującej.
Składnia
first(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]
Tę funkcję można również wywołać jako funkcję okna przy użyciu klauzuli OVER
.
Argumenty
expr
: wyrażenie dowolnego typu.ignoreNull
: opcjonalnyBOOLEAN
literał, który domyślnie ma wartość false.cond
: opcjonalne wyrażenie logiczne filtrujące wiersze używane do agregacji.IGNORE NULLS
lubRESPECT NULLS
: W przypadkuIGNORE NULLS
użycia lubignoreNull
jesttrue
dowolnąexpr
wartością, która ma wartość NULL, jest ignorowana. Wartość domyślna toRESPECT NULLS
.
Zwraca
Wynik ma ten sam typ co expr
.
Ta funkcja nie jest deterministyczna.
Przykłady
> 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
> SELECT first(col) IGNORE NULLS FROM VALUES (10), (5), (NULL) AS tab(col);
5
> SELECT first(col) FILTER (WHERE col > 5) FROM VALUES (5), (20) AS tab(col);
20