first_value
statistische functie
Van toepassing op: Databricks SQL Databricks Runtime
Retourneert de eerste waarde voor expr
een groep rijen. Deze functie is een synoniem voor de eerste statistische functie.
Syntaxis
first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]
Deze functie kan ook worden aangeroepen als een vensterfunctie met behulp van de OVER
component.
Argumenten
expr
: Een expressie van elk type.ignoreNull
: Een optioneleBOOLEAN
letterlijke eigenschap die standaard onwaar is.cond
: Een optionele Boole-expressie die de rijen filtert die worden gebruikt voor aggregatie.IGNORE NULLS
ofRESPECT NULLS
: wanneerIGNORE NULLS
wordt gebruikt ofignoreNull
eenexpr
waarde is die NULL istrue
, wordt genegeerd. De standaardwaarde isRESPECT NULLS
.
Retouren
Het resultaat heeft hetzelfde type als expr
.
Deze functie is niet-deterministisch.
Voorbeelden
> 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);
5
> SELECT first_value(col) FILTER (WHERE col > 5) FROM VALUES (5), (20) AS tab(col);
20