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.