generate_series(start, stop, step) renvoie une ligne par valeur, de start jusqu'à stop inclus, en avançant de step (1 si vous l'omettez). Elle marche avec des entiers, des numerics et des timestamps avec un pas en interval. Utilisez-la dans FROM comme une table.
Cette requête renvoie 1, 4, 7 et 10 avec leurs carrés. Un pas négatif compte à rebours : generate_series(5, 1, -2) donne 5, 3, 1. Une série qui ne peut pas atteindre sa fin, comme generate_series(5, 1), ne renvoie aucune ligne. generate_series(0, 1, 0.25) avance par numerics.
Générer une série de dates
Passez des timestamps ou des dates avec un pas interval. Il n'existe pas de version date, donc les valeurs reviennent en timestamptz ; convertissez-les avec ::date :
Cinq jours reviennent, du 26 février au 2 mars, par-dessus la fin du mois. N'importe quel interval sert de pas : interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week'.
Avec des valeurs timestamptz, un pas de interval '1 day' suit le calendrier du TimeZone de la session. Lors d'un changement d'heure, un pas peut durer 23 ou 25 heures. Depuis PostgreSQL 16, un quatrième argument indique le fuseau dans lequel avancer, quel que soit celui de la session :
SELECT generate_series(
timestamptz '2026-03-28 00:00 Europe/Berlin',
timestamptz '2026-03-31 00:00 Europe/Berlin',
interval '1 day',
'Europe/Berlin');
Combler les jours manquants d'un rapport
Un GROUP BY sur vos données ne renvoie que les périodes qui ont des lignes. Pour afficher chaque jour, avec zéro pour les jours sans commande, générez les jours et faites un LEFT JOIN des données dessus :
Le 1er novembre a 2 commandes, le 4 en a 1, et les 2, 3 et 5 affichent 0. Comptez une colonne de la table jointe (count(o.id)), pas count(*), sinon chaque jour vide compte pour 1.
Comparer created_at à un intervalle, plutôt que created_at::date = d, permet d'utiliser un index sur created_at. Le même principe avec interval '1 month' et date_trunc comble les mois vides (voir les fonctions de date).
Générer des données de test
Un INSERT ... SELECT depuis une série crée autant de lignes que nécessaire en une seule instruction :
La table reçoit 1 000 utilisateurs répartis sur 30 jours d'inscription. Les valeurs sont calculées à partir de i, donc chaque exécution donne le même résultat ; utilisez random() si vous voulez qu'elles varient. Générez un million de lignes de la même façon pour tester un index et comparer les plans avec EXPLAIN ANALYZE.
Numéroter les lignes et utiliser une série dans une jointure
WITH ORDINALITY ajoute une colonne de position à n'importe quelle fonction qui renvoie un ensemble :
Cette requête liste cinq créneaux de 15 minutes de 09:00 à 10:00, numérotés de 1 à 5. Une série marche aussi dans un CROSS JOIN, par exemple pour associer chaque utilisateur à chaque jour d'un mois.
generate_series dans la liste du SELECT renvoie aussi plusieurs lignes, mais deux appels de longueurs différentes complètent le plus court avec des NULL. Gardez les fonctions qui renvoient un ensemble dans FROM. Pour les séries qu'une seule fonction ne peut pas exprimer, comme le parcours d'un arbre, utilisez une CTE récursive.
Questions fréquentes
generate_series inclut-elle la valeur de fin ?
Oui, quand les pas tombent dessus : generate_series(1, 5) renvoie 1 à 5. Sinon, la série s'arrête à la dernière valeur qui ne dépasse pas la fin, donc generate_series(1, 10, 4) renvoie 1, 5 et 9.
MySQL a-t-il generate_series ?
Non. En MySQL, on construit une série avec une CTE récursive (WITH RECURSIVE), qui marche aussi en PostgreSQL mais demande plus de code.
Pourquoi generate_series avec des dates renvoie-t-elle des timestamps ?
La fonction n'a pas de version date, donc PostgreSQL utilise la version timestamptz. Reconvertissez chaque valeur avec ::date.
Comment générer un nombre aléatoire pour chaque ligne ?
Appelez random() dans la liste du select : SELECT i, random() FROM generate_series(1, 5) AS i donne une valeur entre 0 et 1 pour chaque ligne, et floor(random() * 100)::int un entier de 0 à 99. Depuis PostgreSQL 17, random(1, 100) renvoie directement un entier aléatoire dans cet intervalle.