first_value
função agregar
Aplica-se a: Databricks SQL Databricks Runtime
Devolve o primeiro valor de expr
para um grupo de linhas. Esta função é um sinónimo para a primeira função de agregação.
Sintaxe
first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]
Esta função também pode ser invocada como uma função de janela com a OVER
cláusula .
Argumentos
expr
: uma expressão de qualquer tipo.ignoreNull
: uma predefinição literal BOOLEAN opcional para falso.cond
: uma expressão booleana opcional que filtra as linhas utilizadas para agregação.IGNORE NULLS
ouRESPECT NULLS
: QuandoIGNORE NULLS
é utilizado ouignoreNull
étrue
ignorado qualquerexpr
valor nulo. A predefinição éRESPECT NULLS
.
Devoluções
O resultado tem o mesmo tipo que expr
.
Esta função não é determinista.
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