Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

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 ROW
  • ROWS 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.