Compartilhar via

Função de agregação first_value

  • Artigo

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva Runtime do Databricks

Retorna o primeiro valor de expr em um grupo de linhas. Essa função é um sinônimo para a primeira função de agregação.

Sintaxe

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

Essa 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 booliana opcional que filtra as linhas usadas para agregação.
  • IGNORE NULLS ou RESPECT NULLS: quando IGNORE NULLS é usado ou ignoreNull é true, qualquer valor de expr NULL é ignorado. O padrão é RESPECT NULLS.

Retornos

O resultado tem o mesmo tipo de expr.

Essa 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