first 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 di first_value funzione di aggregazione.

Sintassi

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