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.
LAG
Retorna o resultado da avaliação de uma expressão em uma linha anterior da partição.
A primeira forma de LAG() retorna o resultado da avaliação da expressão na linha anterior da partição. Ou, se não houver linha anterior (porque a linha atual é a primeira), retorna NULL.
Se o argumento offset for informado, ele deve ser um inteiro não negativo. O valor retornado é o resultado da avaliação da expressão na linha que fica offset linhas antes da linha atual dentro da partição. Se offset for 0, a expressão é avaliada na linha atual. Se não houver uma linha offset linhas antes da linha atual, a função retorna NULL.
Se um valor padrão também for informado, ele é retornado no lugar de NULL caso a linha identificada por offset não exista.
Sintaxe
SELECT LAG(expr) OVER ([PARTITION BY column] ORDER BY column) FROM <multipartIdentifier>;
SELECT LAG(expr, offset) OVER ([PARTITION BY column] ORDER BY column) FROM <multipartIdentifier>;
SELECT LAG(expr, offset, default) OVER ([PARTITION BY column] ORDER BY column) FROM <multipartIdentifier>;
Argumentos
expr A expressão a ser avaliada na linha anterior.
offset Opcional. Um inteiro não negativo que especifica quantas linhas voltar. Valor padrão: 1.
default
Opcional. O valor a ser retornado se a linha indicada por offset não existir. Valor padrão: NULL.
PARTITION BY column
Opcional. Divide o conjunto de resultados em partições. A função LAG é aplicada dentro de cada partição separadamente.
ORDER BY column Especifica a ordem em que as linhas são processadas.
Valor(es) retornado(s)
Retorna o valor da expressão avaliada na linha anterior especificada, ou NULL (ou o valor padrão) se essa linha não existir.
Exemplos
Comparar cada versão com a versão anterior
-- Compare each release to previous and next release dates
SELECT
tag_name,
name,
published_at,
LAG(tag_name, 1) OVER (ORDER BY published_at) as previous_release,
LAG(published_at, 1) OVER (ORDER BY published_at) as previous_release_date,
julianday(published_at) - julianday(LAG(published_at, 1) OVER (ORDER BY published_at)) as days_since_last_release
FROM github.repos.releases
WHERE owner = 'stackql'
AND repo = 'stackql'
ORDER BY published_at;
Analisar os intervalos entre a criação de issues
-- Analyze gaps between issue creation
SELECT
number,
title,
created_at,
LAG(created_at, 1) OVER (ORDER BY created_at) as prev_issue_date,
julianday(created_at) - julianday(LAG(created_at, 1) OVER (ORDER BY created_at)) as days_since_prev_issue
FROM github.issues.issues
WHERE owner = 'stackql'
AND repo = 'stackql'
ORDER BY created_at;
Para obter mais informações, consulte https://sqlite.org/windowfunctions.html#built-in_window_functions.