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

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

NTH_VALUE

Повертає значення виразу, обчисленого для рядка з номером N у рамці вікна.

Ця вбудована віконна функція обчислює рамку вікна для кожного рядка так само, як агрегатна віконна функція. Вона повертає значення виразу, обчисленого для рядка N рамки вікна. Рядки в рамці вікна нумеруються, починаючи з 1, у порядку, визначеному реченням ORDER BY, якщо воно є, або в довільному порядку в іншому разі. Якщо рядка з номером N у рамці вікна немає, то повертається NULL.

Див. також: [SELECT] [FIRST_VALUE] [LAST_VALUE]


Синтаксис​

SELECT NTH_VALUE(expr, N) OVER (
[PARTITION BY column]
ORDER BY column
[ROWS BETWEEN frame_start AND frame_end]
) FROM <multipartIdentifier>;

Аргументи​

expr Вираз, який обчислюється для рядка з номером N у рамці вікна.

N Додатне ціле число, що визначає номер рядка, який потрібно отримати (нумерація з 1).

PARTITION BY column Необов'язковий. Поділяє набір результатів на секції. Функція NTH_VALUE застосовується в межах кожної секції окремо.

ORDER BY column Визначає порядок, у якому обробляються рядки.

ROWS BETWEEN frame_start AND frame_end Необов'язковий. Визначає рамку вікна.

Значення, що повертається​

Повертає значення виразу, обчисленого для рядка з номером N у рамці вікна, або NULL, якщо рядка з номером N не існує.


Приклади​

Отримання трьох найактивніших учасників​

-- 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';

Докладніше див. https://sqlite.org/windowfunctions.html#built-in_window_functions.