Condividi tramite


first_value funzione di aggregazione

Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Restituisce il primo valore di expr per un gruppo di righe. Questa funzione è un sinonimo della prima funzione di aggregazione.

Sintassi

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

Questa funzione può anche essere richiamata come funzione window usando la OVER clausola .

Argomenti

  • expr: espressione di qualsiasi tipo.
  • ignoreNull: valore letterale facoltativo BOOLEAN che per impostazione predefinita è false.
  • cond: espressione booleana facoltativa che filtra le righe usate per l'aggregazione.
  • IGNORE NULLS o RESPECT NULLS: quando IGNORE NULLS viene usato o ignoreNull è true un expr valore null viene ignorato. Il valore predefinito è RESPECT NULLS.

Valori restituiti

Il risultato ha lo stesso tipo di expr.

Questa funzione non è deterministica.

Esempi

> 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