Menu

PostgreSQL generate_series: liczby, daty i luki

generate_series zwraca zbiór wierszy od wartości początkowej do końcowej: liczby, daty i znaczniki czasu. Użyj jej, żeby uzupełnić luki w raportach, wygenerować dane testowe i zbudować kalendarz.

Na tej stronie są działające edytory: edytuj, uruchamiaj i od razu zobacz wynik.

generate_series(start, stop, step) zwraca jeden wiersz na każdą wartość od start do stop włącznie, z krokiem step (1, jeśli go pominiesz). Działa z liczbami całkowitymi, wartościami numeric i znacznikami czasu z krokiem w postaci interwału. Używasz jej w FROM jak tabeli.

Wynik to 1, 4, 7 i 10 z ich kwadratami. Ujemny krok liczy w dół: generate_series(5, 1, -2) daje 5, 3, 1. Ciąg, który nie może dojść do końca, na przykład generate_series(5, 1), nie zwraca żadnych wierszy. generate_series(0, 1, 0.25) przechodzi przez wartości numeric.

Generowanie ciągu dat

Przekaż znaczniki czasu albo daty z krokiem interval. Nie ma wersji dla date, więc wartości wracają jako timestamptz; zrzutuj je przez ::date:

Wraca pięć dni, od 26 lutego do 2 marca, przez koniec miesiąca. Krokiem może być dowolny interwał: interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week'.

Dla wartości timestamptz krok interval '1 day' trzyma się kalendarza strefy TimeZone sesji. Przy zmianie czasu letniego jeden krok może trwać 23 albo 25 godzin. Od PostgreSQL 16 czwarty argument podaje strefę, w której liczone są kroki, niezależnie od ustawienia sesji:

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

Uzupełnianie brakujących dni w raporcie

GROUP BY po twoich danych zwraca tylko okresy, w których są wiersze. Żeby pokazać każdy dzień, z zerem dla dni bez zamówień, wygeneruj dni i dołącz do nich dane przez LEFT JOIN:

1 listopada ma 2 zamówienia, 4 listopada 1, a 2, 3 i 5 pokazują 0. Licz kolumnę dołączonej tabeli (count(o.id)), a nie count(*), bo inaczej każdy pusty dzień liczy się jako 1.

Porównanie created_at z zakresem zamiast created_at::date = d pozwala użyć indeksu na created_at. Ten sam wzorzec z interval '1 month' i date_trunc uzupełnia puste miesiące (zobacz funkcje dat).

Generowanie danych testowych

INSERT ... SELECT z ciągu tworzy w jednym poleceniu tyle wierszy, ile potrzebujesz:

Tabela dostaje 1000 użytkowników rozłożonych na 30 dni rejestracji. Wartości są liczone z i, więc każde uruchomienie daje ten sam wynik; użyj random(), gdy mają się różnić. W ten sam sposób wygeneruj milion wierszy, żeby wypróbować indeks i porównać plany przez EXPLAIN ANALYZE.

Numerowanie wierszy i ciągi w złączeniach

WITH ORDINALITY dodaje kolumnę z pozycją do każdej funkcji zwracającej zbiór:

To wypisuje pięć 15-minutowych okienek od 09:00 do 10:00, ponumerowanych od 1 do 5. Ciąg działa też w CROSS JOIN, na przykład żeby połączyć każdego użytkownika z każdym dniem miesiąca.

generate_series na liście SELECT też zwraca kilka wierszy, ale przy dwóch takich wywołaniach różnej długości krótsze jest dopełniane wartościami NULL. Trzymaj funkcje zwracające zbiory w FROM. Dla ciągów, których nie wyrazi jedna funkcja, na przykład przechodzenia drzewa, użyj rekurencyjnego CTE.

Najczęściej zadawane pytania

Czy generate_series obejmuje wartość końcową?

Tak, gdy kroki na nią trafiają: generate_series(1, 5) zwraca od 1 do 5. Gdy nie trafiają, ciąg kończy się na ostatniej wartości, która nie przekracza końca, więc generate_series(1, 10, 4) zwraca 1, 5 i 9.

Czy MySQL ma generate_series?

Nie. W MySQL ciąg buduje się rekurencyjnym CTE (WITH RECURSIVE), co działa też w PostgreSQL, ale jest dłuższe do napisania.

Dlaczego generate_series z datami zwraca znaczniki czasu?

Nie ma wersji funkcji dla date, więc PostgreSQL używa wersji dla timestamptz. Zrzutuj każdą wartość z powrotem przez ::date.

Jak wygenerować losową liczbę dla każdego wiersza?

Wywołaj random() na liście kolumn: SELECT i, random() FROM generate_series(1, 5) AS i daje wartość od 0 do 1 dla każdego wiersza, a floor(random() * 100)::int liczbę całkowitą od 0 do 99. Od PostgreSQL 17 random(1, 100) zwraca losową liczbę całkowitą z tego zakresu bezpośrednio.

Ilustracja języków programowania w Coddy

Ucz się programowania z Coddy

Zacznij