first_value-Aggregatfunktion

  • Artikel

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Gibt den ersten Wert von expr für eine Zeilengruppe zurück. Diese Funktion ist ein Synonym für die first-Aggregatfunktion.

Syntax

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

Diese Funktion kann auch mithilfe der OVER-Klausel als Fensterfunktion aufgerufen werden.

Argumente

  • expr: Ein Ausdruck beliebigen Typs
  • ignoreNull: Ein optionales BOOLEAN-Literal, das standardmäßig auf FALSE festgelegt ist.
  • cond: Ein optionaler boolescher Ausdruck, der die für die Aggregation verwendeten Zeilen filtert.
  • IGNORE NULLS oder RESPECT NULLS: Wenn IGNORE NULLS verwendet wird oder ignoreNulltrue ist, wird jeder expr-Wert, der NULL ist, ignoriert. Der Standardwert lautet RESPECT NULLS.

Gibt zurück

Das Ergebnis hat den gleichen Typ wie expr.

Diese Funktion ist nicht deterministisch.

Beispiele

> 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