Freigeben über

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

Syntax

first(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(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