first_value aggregatfunktion

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Returnerar det första värdet expr för för en grupp rader. Den här funktionen är synonym för first aggregerad funktion.

Syntax

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

Den här funktionen kan också anropas som en -fönsterfunktion med hjälp av OVER-satsen.

Argument

  • expr: Ett uttryck av valfri typ.
  • ignoreNull: En valfri BOOLEAN literal som har standardvärdet falsk.
  • cond: Ett valfritt booleskt uttryck som filtrerar de rader som används för aggregering.
  • IGNORE NULLS eller RESPECT NULLS: När IGNORE NULLS används eller ignoreNull är true ett expr värde som är NULL ignoreras. Standardvärdet är RESPECT NULLS.

Returer

Resultatet har samma typ som expr.

Den här funktionen är icke-deterministisk.

Exempel

> 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