Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

NTH_VALUE

Retorna o valor da expressão avaliada na N-ésima linha do quadro da janela.

Esta função de janela integrada calcula o quadro da janela de cada linha da mesma forma que uma função de janela de agregação. Ela retorna o valor da expressão avaliada na linha N do quadro da janela. As linhas são numeradas dentro do quadro da janela a partir de 1, na ordem definida pela cláusula ORDER BY, se houver, ou em ordem arbitrária caso contrário. Se não houver uma N-ésima linha na partição, a função retorna NULL.

Veja também: [SELECT] [FIRST_VALUE] [LAST_VALUE]


Sintaxe​

SELECT NTH_VALUE(expr, N) OVER (
[PARTITION BY column]
ORDER BY column
[ROWS BETWEEN frame_start AND frame_end]
) FROM <multipartIdentifier>;

Argumentos​

expr A expressão a ser avaliada na N-ésima linha do quadro da janela.

N Um inteiro positivo que especifica o número da linha a ser obtida (indexado a partir de 1).

PARTITION BY column Opcional. Divide o conjunto de resultados em partições. A função NTH_VALUE é aplicada dentro de cada partição separadamente.

ORDER BY column Especifica a ordem em que as linhas são processadas.

ROWS BETWEEN frame_start AND frame_end Opcional. Define o quadro da janela.

Valor(es) retornado(s)​

Retorna o valor da expressão avaliada na N-ésima linha do quadro da janela, ou NULL se a N-ésima linha não existir.


Exemplos​

Obter os três colaboradores com mais contribuições​

-- Get the top 3 contributors by number of contributions
SELECT
login,
contributions,
NTH_VALUE(login, 1) OVER (ORDER BY contributions DESC
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) as top_contributor,
NTH_VALUE(login, 2) OVER (ORDER BY contributions DESC
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) as second_contributor,
NTH_VALUE(login, 3) OVER (ORDER BY contributions DESC
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) as third_contributor
FROM github.repos.contributors
WHERE owner = 'stackql'
AND repo = 'stackql';

Para obter mais informações, consulte https://sqlite.org/windowfunctions.html#built-in_window_functions.