Partilhar via

first_value função agregada

Aplica-se a:assinalado sim Databricks SQL assinalado sim Databricks Runtime

Devolve o primeiro valor de expr para um grupo de linhas. Esta função é sinónimo de first função agregada.

Sintaxe

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

Esta função também pode ser invocada como uma função de janela usando a cláusula OVER.

Argumentos

  • expr: Uma expressão de qualquer tipo.
  • ignoreNull: Um literal opcional BOOLEAN cujo padrão é false.
  • cond: Uma expressão booleana opcional filtrando as linhas usadas para agregação.
  • IGNORE NULLS ou RESPECT NULLS: Quando IGNORE NULLS é usado ou ignoreNull é true qualquer expr valor que é NULL é ignorado. A predefinição é RESPECT NULLS.

Devoluções

O resultado tem o mesmo tipo que expr.

Esta função não é determinística.

Exemplos

> 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
  • Last updated on