FIRST_VALUE

📖 Описание

Функция Oracle SQL FIRST_VALUE возвращает первое значение в упорядоченном аналитическом окне. Связанные функции: LAST_VALUE и NTH_VALUE.


🧩 Синтаксис

FIRST_VALUE(expression) [RESPECT NULLS | IGNORE NULLS]
  OVER (analytic_clause)

Допустима и эквивалентная форма с указанием обработки NULL внутри скобок:

FIRST_VALUE(expression [RESPECT NULLS | IGNORE NULLS])
  OVER (analytic_clause)

⚙️ Параметры и аргументы

expression — возвращаемый столбец или выражение; аналитические функции нельзя вкладывать в это выражение. RESPECT NULLS учитывает NULL и действует по умолчанию; IGNORE NULLS пропускает NULL, но возвращает NULL, если других значений нет.

PARTITION BY задаёт разделы, ORDER BY — порядок, оконная рамка — строки, участвующие в вычислении. Тип результата соответствует типу выражения.

Рамка Значение
RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW От начала до текущего ключа сортировки включительно; по умолчанию
RANGE BETWEEN CURRENT ROW AND UNBOUNDED FOLLOWING От текущего ключа до конца
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING Все строки раздела

Первое значение определяется началом выбранной рамки; для постоянного результата по всему разделу можно явно задать полное окно. При ROWS уникальный дополнительный ключ сортировки делает выбор строки однозначным.


💻 Примеры

Используем веса девяти посылок. Каждый запрос содержит полный набор данных:

PARCEL_ID ROUTE_ID WEIGHT_KG
301 10 14
302 10 18
303 10 11
304 20 22
305 20 17
306 20 13
307 20 28
308 30 16
309 30 30

Наибольший вес среди всех посылок

WITH parcel_weights (parcel_id, route_id, weight_kg) AS (
  SELECT 301, 10, 14 FROM dual UNION ALL
  SELECT 302, 10, 18 FROM dual UNION ALL
  SELECT 303, 10, 11 FROM dual UNION ALL
  SELECT 304, 20, 22 FROM dual UNION ALL
  SELECT 305, 20, 17 FROM dual UNION ALL
  SELECT 306, 20, 13 FROM dual UNION ALL
  SELECT 307, 20, 28 FROM dual UNION ALL
  SELECT 308, 30, 16 FROM dual UNION ALL
  SELECT 309, 30, 30 FROM dual
)
SELECT DISTINCT FIRST_VALUE(weight_kg) OVER (
         ORDER BY weight_kg DESC, parcel_id
         ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
       ) AS highest_weight
FROM parcel_weights;
HIGHEST_WEIGHT
30

Сортировка по убыванию помещает наибольший вес в начало полного окна. PARTITION BY отсутствует: все строки входят в один раздел.

Наибольший вес по маршруту

WITH parcel_weights (parcel_id, route_id, weight_kg) AS (
  SELECT 301, 10, 14 FROM dual UNION ALL
  SELECT 302, 10, 18 FROM dual UNION ALL
  SELECT 303, 10, 11 FROM dual UNION ALL
  SELECT 304, 20, 22 FROM dual UNION ALL
  SELECT 305, 20, 17 FROM dual UNION ALL
  SELECT 306, 20, 13 FROM dual UNION ALL
  SELECT 307, 20, 28 FROM dual UNION ALL
  SELECT 308, 30, 16 FROM dual UNION ALL
  SELECT 309, 30, 30 FROM dual
)
SELECT DISTINCT route_id,
       FIRST_VALUE(weight_kg) OVER (
         PARTITION BY route_id ORDER BY weight_kg DESC, parcel_id
         ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
       ) AS highest_weight
FROM parcel_weights
WHERE route_id IN (10, 20)
ORDER BY route_id;
ROUTE_ID HIGHEST_WEIGHT
10 18
20 28

PARTITION BY route_id выполняет отдельный расчёт для каждого маршрута; DISTINCT оставляет одну строку на маршрут.

Наименьший вес по маршруту

WITH parcel_weights (parcel_id, route_id, weight_kg) AS (
  SELECT 301, 10, 14 FROM dual UNION ALL
  SELECT 302, 10, 18 FROM dual UNION ALL
  SELECT 303, 10, 11 FROM dual UNION ALL
  SELECT 304, 20, 22 FROM dual UNION ALL
  SELECT 305, 20, 17 FROM dual UNION ALL
  SELECT 306, 20, 13 FROM dual UNION ALL
  SELECT 307, 20, 28 FROM dual UNION ALL
  SELECT 308, 30, 16 FROM dual UNION ALL
  SELECT 309, 30, 30 FROM dual
)
SELECT DISTINCT route_id,
       FIRST_VALUE(weight_kg) OVER (
         PARTITION BY route_id ORDER BY weight_kg ASC, parcel_id
         ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
       ) AS lowest_weight
FROM parcel_weights
WHERE route_id IN (10, 20)
ORDER BY route_id;
ROUTE_ID LOWEST_WEIGHT
10 11
20 13

Обратный порядок сортировки позволяет получить наименьшее значение. В этих данных NULL нет; в общем случае FIRST_VALUE возвращает значение строки, выбранной порядком и рамкой, и не является прямой заменой MIN.

См. документацию Oracle: FIRST_VALUE.