Delen via

first_value statistische functie

Van toepassing op:aangevinkt ja Databricks SQL aangevinkt ja Databricks Runtime

Geeft de eerste waarde van expr terug voor 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 clausule.

Argumenten

  • expr: Een expressie van elk type.
  • ignoreNull: Een optionele BOOLEAN letterlijke waarde die standaard onwaar is.
  • cond: Een optionele Boole-expressie die de rijen filtert die worden gebruikt voor aggregatie.
  • IGNORE NULLS of RESPECT NULLS: wanneer IGNORE NULLS wordt gebruikt of ignoreNulltrue een waarde NULL is, wordt elke expr waarde genegeerd. De standaardwaarde is RESPECT 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