SQL Academy
Premium
Funktionsreferenz

GENERATE_SERIES

Entsprechung in MySQL:

Erzeugt eine Reihe von Werten von start bis stop mit der angegebenen Schrittweite, eine Zeile pro Wert.

PostgreSQL 17.5
GENERATE_SERIES(start, stop [, step])

Parameter

startinteger | numeric | timestamp
Erster Wert der Reihe
stopinteger | numeric | timestamp
Grenze der Reihe, gehört dazu, wenn die Schrittweite sie trifft
stepinteger | numeric | intervaloptional
Schrittweite, standardmäßig 1; bei Datumswerten Pflicht und als Intervall angegeben

Rückgabewert

Menge von Zeilen vom Typ von start (bei DATE timestamp with time zone); leere Menge, wenn start bei positiver Schrittweite größer als stop ist oder bei negativer kleiner

Beispiele

Zahlen mit Schrittweite 3

PostgreSQL 17.5
SELECT GENERATE_SERIES(1, 10, 3);
generate_series
1
4
7
10

Datumswerte Tag für Tag

PostgreSQL 17.5
SELECT GENERATE_SERIES(
		DATE '2024-03-01',
		DATE '2024-03-05',
		INTERVAL '1 day'
	)::DATE AS DAY;
day
2024-03-01
2024-03-02
2024-03-03
2024-03-04
2024-03-05

Reihe in FROM wie eine Tabelle

PostgreSQL 17.5
SELECT n,
	n * n AS square
FROM GENERATE_SERIES(1, 5) AS n;
nsquare
11
24
39
416
525

Zahlungen nach Monaten, auch leere

PostgreSQL 17.5
SELECT TO_CHAR(m, 'YYYY-MM') AS MONTH,
	COUNT(p.payment_id) AS payments
FROM GENERATE_SERIES(
		DATE '2005-01-01',
		DATE '2005-12-01',
		INTERVAL '1 month'
	) AS m
	LEFT JOIN Payments AS p ON DATE_TRUNC('month', p.date) = m
GROUP BY m
ORDER BY m;
monthpayments
2005-010
2005-023
2005-033
2005-041
2005-052
2005-066
2005-073
2005-081
2005-092
2005-102

Countdown mit negativer Schrittweite

PostgreSQL 17.5
SELECT GENERATE_SERIES(10, 1, -3) AS countdown;
countdown
10
7
4
1

Details

Meist steht die Funktion wie eine Tabelle in FROM: FROM GENERATE_SERIES(1, 5) AS n. So kannst du zum Beispiel alle Monate eines Jahres erzeugen und Daten mit LEFT JOIN daran anschließen, um Monate ohne Einträge zu sehen.

Eine Schrittweite von 0 führt zu einem Fehler. Bei negativer Schrittweite läuft die Reihe abwärts, start muss dann größer als stop sein.

Siehe auch