Menu

PostgreSQL generate_series: Zahlen, Daten und Lücken

generate_series liefert eine Menge von Zeilen von einem Start- bis zu einem Endwert: Zahlen, Daten und Timestamps. Damit füllst du Lücken in Berichten, erzeugst Testdaten und baust Kalender.

Diese Seite enthält ausführbare Editoren. Bearbeiten, ausführen und Ausgabe sofort sehen.

generate_series(start, stop, step) liefert eine Zeile pro Wert von start bis einschließlich stop, in Schritten von step (1, wenn du ihn weglässt). Das klappt mit Integern, numeric-Werten und Timestamps mit einem Intervall als Schritt. Du nutzt die Funktion in FROM wie eine Tabelle.

Das liefert 1, 4, 7 und 10 mit ihren Quadraten. Ein negativer Schritt zählt rückwärts: generate_series(5, 1, -2) ergibt 5, 3, 1. Eine Reihe, die ihr Ende nicht erreichen kann, etwa generate_series(5, 1), liefert keine Zeilen. generate_series(0, 1, 0.25) läuft in Schritten durch numeric-Werte.

Eine Datumsreihe erzeugen

Übergib Timestamps oder Daten mit einem interval als Schritt. Es gibt keine date Variante, die Werte kommen also als timestamptz zurück; caste sie mit ::date:

Fünf Tage kommen zurück, vom 26. Februar bis zum 2. März, über das Monatsende hinweg. Jedes Intervall taugt als Schritt: interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week'.

Bei timestamptz Werten folgt ein Schritt von interval '1 day' dem Kalender der TimeZone der Sitzung. Bei einer Zeitumstellung kann ein Schritt 23 oder 25 Stunden lang sein. Seit PostgreSQL 16 nennt ein viertes Argument die Zone, in der gerechnet wird, egal was die Sitzung nutzt:

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

Fehlende Tage in einem Bericht füllen

Ein GROUP BY über deine Daten liefert nur Zeiträume, in denen es Zeilen gibt. Um jeden Tag zu zeigen, mit einer Null für Tage ohne Bestellungen, erzeugst du die Tage und hängst die Daten per LEFT JOIN an:

Der 1. November hat 2 Bestellungen, der 4. November 1, und der 2., 3. und 5. zeigen 0. Zähl eine Spalte der gejointen Tabelle (count(o.id)), nicht count(*), sonst zählt jeder leere Tag als 1.

Der Vergleich von created_at mit einem Bereich statt created_at::date = d erlaubt die Nutzung eines Index auf created_at. Dasselbe Muster mit interval '1 month' und date_trunc füllt leere Monate (siehe Datumsfunktionen).

Testdaten erzeugen

INSERT ... SELECT aus einer Reihe legt in einer Anweisung so viele Zeilen an, wie du brauchst:

Die Tabelle bekommt 1.000 Nutzer, verteilt über 30 Anmeldetage. Die Werte werden aus i berechnet, jeder Lauf liefert also dasselbe Ergebnis; nimm random(), wenn sie variieren sollen. Erzeuge auf dieselbe Weise eine Million Zeilen, um einen Index auszuprobieren und Pläne mit EXPLAIN ANALYZE zu vergleichen.

Zeilen nummerieren und Reihen in Joins nutzen

WITH ORDINALITY ergänzt jede Funktion, die Mengen liefert, um eine Positionsspalte:

Das listet fünf Zeitfenster zu 15 Minuten von 09:00 bis 10:00 auf, nummeriert von 1 bis 5. Eine Reihe funktioniert auch in einem CROSS JOIN, etwa um jeden Nutzer mit jedem Tag eines Monats zu kombinieren.

generate_series in der SELECT Liste liefert ebenfalls mehrere Zeilen, aber bei zwei solchen Aufrufen unterschiedlicher Länge wird der kürzere mit NULL aufgefüllt. Lass Funktionen, die Mengen liefern, in FROM. Für Reihen, die eine einzelne Funktion nicht ausdrücken kann, etwa das Durchlaufen eines Baums, nimmst du eine rekursive CTE.

Häufig gestellte Fragen

Enthält generate_series den Endwert?

Ja, wenn die Schritte genau darauf landen: generate_series(1, 5) liefert 1 bis 5. Wenn nicht, endet die Reihe beim letzten Wert, der das Ende nicht überschreitet. generate_series(1, 10, 4) liefert also 1, 5 und 9.

Hat MySQL generate_series?

Nein. In MySQL baust du eine Reihe mit einer rekursiven CTE (WITH RECURSIVE). Das funktioniert auch in PostgreSQL, ist aber länger zu schreiben.

Warum liefert generate_series mit Daten Timestamps?

Es gibt keine date Variante der Funktion, also nimmt PostgreSQL die mit timestamptz. Caste jeden Wert mit ::date zurück.

Wie erzeuge ich eine Zufallszahl für jede Zeile?

Ruf random() in der Select-Liste auf: SELECT i, random() FROM generate_series(1, 5) AS i liefert für jede Zeile einen Wert zwischen 0 und 1, und floor(random() * 100)::int einen Integer von 0 bis 99. Seit PostgreSQL 17 liefert random(1, 100) direkt einen zufälligen Integer in diesem Bereich.

Illustration der Programmiersprachen bei Coddy

Lerne mit Coddy zu programmieren

Los geht's