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
ouRESPECT NULLS
: QuandoIGNORE NULLS
é usado ouignoreNull
étrue
qualquerexpr
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