nth_value
função de janela analítica
Aplica-se a: Databricks SQL
Databricks Runtime
Retorna o valor em um offset
específico na janela.
Sintaxe
nth_value(expr, offset) [ IGNORE NULLS | RESPECT NULLS ] OVER clause
Argumentos
-
expr
: Uma expressão de qualquer tipo. -
offset
: Um literal inteiro maior que 0. -
IGNORE NULLS
ouRESPECT NULLS
: QuandoIGNORE NULLS
é usado, qualquerexpr
valor que é NULL é ignorado na contagem. A predefinição éRESPECT NULLS
. - Cláusula OVER: A cláusula que descreve a janela. Consulte: Funções da janela.
Devoluções
O tipo de resultado corresponde ao expr
tipo.
A função window retorna o valor de expr
na linha que é a offset
ª desde o início da moldura da janela.
Se não houver essa offset
linha, retorna NULL
.
Deve usar a cláusula ORDER BY e com esta função. Se a ordem não for exclusiva, o resultado não será determinístico.
Exemplos
> SELECT a, b, nth_value(b, 2) OVER (PARTITION BY a ORDER BY b)
FROM VALUES ('A1', 2), ('A1', 1), ('A2', 3), ('A1', 1) tab(a, b);
A1 1 1
A1 1 1
A1 2 1
A2 3 NULL