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.
FIRST_VALUE
Retorna o valor da expressão avaliada na primeira 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. Para cada linha, ela retorna o valor da expressão avaliada na primeira linha do quadro da janela.
Veja também:
[SELECT] [LAST_VALUE] [NTH_VALUE]
Sintaxe
SELECT FIRST_VALUE(expr) 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 primeira linha do quadro da janela.
PARTITION BY column
Opcional. Divide o conjunto de resultados em partições. A função FIRST_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. As opções comuns incluem:
ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROWROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
Sem uma cláusula de quadro, o quadro é RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW: ele termina na última linha empatada com a linha atual nas colunas de ORDER BY, e não na linha atual.
Valor(es) retornado(s)
Retorna o valor da expressão avaliada na primeira linha do quadro da janela.
Exemplos
Encontrar a primeira versão para contextualizar
-- Find first and latest release for context
SELECT
tag_name,
name,
published_at,
FIRST_VALUE(tag_name) OVER (
ORDER BY published_at
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
) as first_release,
LAST_VALUE(tag_name) OVER (
ORDER BY published_at
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
) as latest_release
FROM github.repos.releases
WHERE owner = 'stackql'
AND repo = 'stackql';
Por padrão, o quadro da janela se estende do início da partição até a linha atual. Para incluir todas as linhas da partição, use ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING.
Para obter mais informações, consulte https://sqlite.org/windowfunctions.html#built-in_window_functions.