generate_series(start, stop, step) mengembalikan satu baris per nilai dari start sampai dan termasuk stop, bergerak sebesar step (1 jika kamu tidak menuliskannya). Fungsi ini bekerja dengan integer, numeric, dan timestamp dengan langkah berupa interval. Pakai di FROM seperti tabel.
Hasilnya 1, 4, 7, dan 10 beserta kuadratnya. Langkah negatif menghitung mundur: generate_series(5, 1, -2) menghasilkan 5, 3, 1. Deret yang tidak bisa mencapai akhirnya, seperti generate_series(5, 1), tidak mengembalikan baris apa pun. generate_series(0, 1, 0.25) melangkah melalui nilai numeric.
Membuat deret tanggal
Berikan timestamp atau tanggal dengan langkah berupa interval. Tidak ada versi date, jadi nilainya kembali sebagai timestamptz; cast dengan ::date:
Lima hari dikembalikan, dari 26 Februari sampai 2 Maret, melewati akhir bulan. Interval apa pun bisa dipakai sebagai langkah: interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week'.
Dengan nilai timestamptz, langkah interval '1 day' mengikuti kalender TimeZone sesi. Saat melewati pergantian daylight saving, satu langkah bisa 23 atau 25 jam. Sejak PostgreSQL 16, argumen keempat menyebut zona yang dipakai untuk melangkah, apa pun zona sesinya:
SELECT generate_series(
timestamptz '2026-03-28 00:00 Europe/Berlin',
timestamptz '2026-03-31 00:00 Europe/Berlin',
interval '1 day',
'Europe/Berlin');
Mengisi hari yang kosong di laporan
GROUP BY pada datamu hanya mengembalikan periode yang punya baris. Untuk menampilkan setiap hari dengan nol untuk hari tanpa pesanan, buat deret harinya lalu LEFT JOIN datanya ke deret itu:
1 November punya 2 pesanan, 4 November punya 1, dan tanggal 2, 3, dan 5 menampilkan 0. Hitung kolom dari tabel yang di-join (count(o.id)), bukan count(*), kalau tidak setiap hari kosong dihitung sebagai 1.
Membandingkan created_at dengan sebuah rentang, alih-alih created_at::date = d, memungkinkan index pada created_at dipakai. Pola yang sama dengan interval '1 month' dan date_trunc mengisi bulan yang kosong (lihat fungsi tanggal).
Membuat data uji
INSERT ... SELECT dari sebuah deret membuat baris sebanyak yang kamu butuhkan dalam satu pernyataan:
Tabelnya mendapat 1.000 pengguna yang tersebar di 30 hari pendaftaran. Nilainya dihitung dari i, jadi setiap eksekusi memberi hasil yang sama; pakai random() saat kamu ingin nilainya bervariasi. Buat sejuta baris dengan cara yang sama untuk mencoba index dan membandingkan rencana dengan EXPLAIN ANALYZE.
Memberi nomor baris dan memakai deret dalam join
WITH ORDINALITY menambahkan kolom posisi ke fungsi apa pun yang mengembalikan set:
Hasilnya lima slot 15 menit dari 09:00 sampai 10:00, bernomor 1 sampai 5. Deret juga bisa dipakai di CROSS JOIN, misalnya untuk memasangkan setiap pengguna dengan setiap hari dalam sebulan.
generate_series di daftar SELECT juga mengembalikan beberapa baris, tapi dua pemanggilan seperti itu dengan panjang berbeda akan mengisi yang lebih pendek dengan NULL. Simpan fungsi yang mengembalikan set di FROM. Untuk deret yang tidak bisa dinyatakan oleh satu fungsi, seperti menelusuri pohon, pakai CTE rekursif.
Pertanyaan yang sering diajukan
Apakah generate_series menyertakan nilai akhir?
Ya, jika langkahnya tepat jatuh di sana: generate_series(1, 5) mengembalikan 1 sampai 5. Jika tidak, deretnya berhenti di nilai terakhir yang tidak melewati akhir, jadi generate_series(1, 10, 4) mengembalikan 1, 5, dan 9.
Apakah MySQL punya generate_series?
Tidak. Di MySQL kamu membuat deret dengan CTE rekursif (WITH RECURSIVE), yang juga berjalan di PostgreSQL tapi lebih panjang ditulis.
Kenapa generate_series dengan tanggal mengembalikan timestamp?
Fungsi ini tidak punya versi date, jadi PostgreSQL memakai versi timestamptz. Cast setiap nilainya kembali dengan ::date.
Bagaimana cara membuat angka acak untuk setiap baris?
Panggil random() di daftar select: SELECT i, random() FROM generate_series(1, 5) AS i memberi nilai antara 0 dan 1 untuk setiap baris, dan floor(random() * 100)::int memberi integer dari 0 sampai 99. Sejak PostgreSQL 17, random(1, 100) langsung mengembalikan integer acak dalam rentang itu.