first função agregar

Aplica-se a: Databricks SQL Databricks Runtime

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

Sintaxe

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

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

Argumentos

• expr: Uma expressão de qualquer tipo.
• ignoreNull: Um padrão literal BOOLEAN opcional para 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(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

Relacionada

• função min aggregate
• Função de agregado máximo
• última função agregada
• first_value função agregada
• Funções do Windows