Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
FIRST_VALUE
Повертає значення виразу, обчисленого для першого рядка в рамці вікна.
Ця вбудована віконна функція обчислює рамку вікна для кожного рядка так само, як агрегатна віконна функція. Для кожного рядка вона повертає значення виразу, обчисленого для першого рядка в рамці вікна.
Див. також:
[SELECT] [LAST_VALUE] [NTH_VALUE]
Синтаксис
SELECT FIRST_VALUE(expr) OVER (
[PARTITION BY column]
ORDER BY column
[ROWS BETWEEN frame_start AND frame_end]
) FROM <multipartIdentifier>;
Аргументи
expr Вираз, який обчислюється для першого рядка в рамці вікна.
PARTITION BY column
Необов'язковий. Поділяє набір результатів на секції. Функція FIRST_VALUE застосовується в межах кожної секції окремо.
ORDER BY column Визначає порядок, у якому обробляються рядки.
ROWS BETWEEN frame_start AND frame_end Необов'язковий. Визначає рамку вікна. Поширені варіанти:
ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROWROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
Якщо речення рамки немає, то рамкою є RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW: вона закінчується на останньому рядку, що має з поточним рядком рівні значення в стовпцях ORDER BY, а не на поточному рядку.
Значення, що повертається
Повертає значення виразу, обчисленого для першого рядка в рамці вікна.
Приклади
Пошук першого випуску для контексту
-- 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';
За замовчуванням рамка вікна простягається від початку секції до останнього рядка, що має з поточним рядком рівні значення в стовпцях ORDER BY. Функція FIRST_VALUE читає перший рядок рамки, тому повертає те саме значення як із рамкою за замовчуванням, так і з ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING; явна рамка має значення для функцій LAST_VALUE і NTH_VALUE, які читають рядки далі в рамці.
Докладніше див. https://sqlite.org/windowfunctions.html#built-in_window_functions.