Menu

generate_series в PostgreSQL: числа, даты и пропуски

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

На этой странице есть исполняемые редакторы: меняйте, запускайте и сразу видите результат.

generate_series(start, stop, step) возвращает по одной строке на каждое значение от start до stop включительно с шагом step (1, если шаг не указан). Функция работает с целыми числами, numeric и метками времени с шагом в виде интервала. Используйте её в FROM, как таблицу.

Запрос возвращает 1, 4, 7 и 10 с их квадратами. Отрицательный шаг считает вниз: generate_series(5, 1, -2) даёт 5, 3, 1. Ряд, который не может дойти до конца, например generate_series(5, 1), не возвращает строк. generate_series(0, 1, 0.25) шагает по значениям numeric.

Ряд дат

Передайте метки времени или даты и шаг типа interval. Версии для date нет, поэтому значения возвращаются как timestamptz; приведите их через ::date:

Возвращаются пять дней, с 26 февраля по 2 марта, через конец месяца. Шагом может быть любой интервал: interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week'.

Для значений timestamptz шаг interval '1 day' следует календарю часового пояса сессии (TimeZone). При переходе на летнее или зимнее время один шаг может длиться 23 или 25 часов. Начиная с PostgreSQL 16, четвёртый аргумент задаёт пояс, в котором идут шаги, независимо от настройки сессии:

SELECT generate_series(
    timestamptz '2026-03-28 00:00 Europe/Berlin',
    timestamptz '2026-03-31 00:00 Europe/Berlin',
    interval '1 day',
    'Europe/Berlin');

Заполнить пропущенные дни в отчёте

GROUP BY по вашим данным возвращает только периоды, в которых есть строки. Чтобы показать каждый день и ноль для дней без заказов, сгенерируйте дни и присоедините к ним данные через LEFT JOIN:

1 ноября 2 заказа, 4 ноября 1, а 2, 3 и 5 ноября показывают 0. Считайте столбец присоединённой таблицы (count(o.id)), а не count(*), иначе каждый пустой день посчитается как 1.

Сравнение created_at с диапазоном вместо created_at::date = d позволяет использовать индекс на created_at. Тот же приём с interval '1 month' и date_trunc заполняет пустые месяцы (см. функции для работы с датами).

Сгенерировать тестовые данные

INSERT ... SELECT из ряда создаёт столько строк, сколько нужно, одной командой:

В таблице появляется 1 000 пользователей, распределённых по 30 дням регистрации. Значения вычисляются из i, так что каждый запуск даёт один и тот же результат; используйте random(), если нужен разброс. Так же можно сгенерировать миллион строк, чтобы попробовать индекс и сравнить планы через EXPLAIN ANALYZE.

Нумерация строк и ряды в соединениях

WITH ORDINALITY добавляет столбец с номером позиции к любой функции, возвращающей набор:

Запрос выводит пять 15-минутных слотов с 09:00 до 10:00 с номерами от 1 до 5. Ряд работает и в CROSS JOIN, например чтобы сопоставить каждого пользователя с каждым днём месяца.

generate_series в списке SELECT тоже возвращает несколько строк, но два таких вызова разной длины дополняют более короткий значениями NULL. Держите функции, возвращающие набор, в FROM. Для рядов, которые одна функция не выразит, например обхода дерева, используйте рекурсивный CTE.

Часто задаваемые вопросы

Включает ли generate_series конечное значение?

Да, если шаги на него попадают: generate_series(1, 5) возвращает от 1 до 5. Если не попадают, ряд заканчивается на последнем значении, которое не выходит за конец, поэтому generate_series(1, 10, 4) возвращает 1, 5 и 9.

Есть ли generate_series в MySQL?

Нет. В MySQL ряд строят рекурсивным CTE (WITH RECURSIVE), который работает и в PostgreSQL, но пишется длиннее.

Почему generate_series с датами возвращает метки времени?

Версии функции для date нет, поэтому PostgreSQL берёт версию для timestamptz. Приведите каждое значение обратно через ::date.

Как получить случайное число для каждой строки?

Вызовите random() в списке выборки: SELECT i, random() FROM generate_series(1, 5) AS i даёт значение от 0 до 1 для каждой строки, а floor(random() * 100)::int целое от 0 до 99. Начиная с PostgreSQL 17, random(1, 100) сразу возвращает случайное целое в этом диапазоне.

Иллюстрация языков программирования Coddy

Учитесь программировать с Coddy

Начать