Teilen über

first_value-Aggregatfunktion

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 first Aggregatfunktion.

Syntax

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

Diese Funktion kann auch mithilfe der -Klausel als OVER 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

> 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
  • Last updated on