Compartilhar via

Função de janela analítica nth_value

  • Artigo

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

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 INTEGER maior que 0.
  • IGNORE NULLS ou RESPECT NULLS: quando IGNORE NULLS é usado, qualquer valor de expr que seja NULL é ignorado na contagem. O padrão é RESPECT NULLS.
  • Cláusula OVER: a cláusula que descreve a janela. Confira: Funções de janela.

Retornos

O tipo de resultado corresponde ao tipo expr.

A função de janela retorna o valor de expr na linha que é a offsetª linha do início do quadro da janela.

Se não houver essa offsetª linha, retornará NULL.

Você deve usar a cláusula ORDER BY com essa função. Se a ordem não for única, 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