generate_series(start, stop, step) restituisce una riga per ogni valore da start fino a stop compreso, avanzando di step (1 se lo ometti). Funziona con interi, numeric e timestamp con un passo di tipo interval. Si usa in FROM come una tabella.
Questo restituisce 1, 4, 7 e 10 con i loro quadrati. Un passo negativo conta all'indietro: generate_series(5, 1, -2) dà 5, 3, 1. Una serie che non può raggiungere la fine, come generate_series(5, 1), non restituisce righe. generate_series(0, 1, 0.25) avanza tra valori numeric.
Generare una serie di date
Passa timestamp o date con un passo interval. Non esiste una versione per date, quindi i valori tornano come timestamptz; convertili con ::date:
Tornano cinque giorni, dal 26 febbraio al 2 marzo, attraverso la fine del mese. Come passo va bene qualsiasi intervallo: interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week'.
Con valori timestamptz, un passo di interval '1 day' segue il calendario della TimeZone della sessione. Durante il cambio dell'ora legale, un passo può durare 23 o 25 ore. Da PostgreSQL 16, un quarto argomento indica il fuso in cui avanzare, qualunque sia quello della sessione:
SELECT generate_series(
timestamptz '2026-03-28 00:00 Europe/Berlin',
timestamptz '2026-03-31 00:00 Europe/Berlin',
interval '1 day',
'Europe/Berlin');
Riempire i giorni mancanti in un report
Un GROUP BY sui tuoi dati restituisce solo i periodi che hanno righe. Per mostrare ogni giorno, con zero nei giorni senza ordini, genera i giorni e collega i dati con un LEFT JOIN:
Il 1 novembre ha 2 ordini, il 4 ne ha 1, e il 2, il 3 e il 5 mostrano 0. Conta una colonna della tabella collegata (count(o.id)), non count(*), altrimenti ogni giorno vuoto conta come 1.
Confrontare created_at con un intervallo, invece di created_at::date = d, permette di usare un indice su created_at. Lo stesso schema con interval '1 month' e date_trunc riempie i mesi vuoti (vedi le funzioni per le date).
Generare dati di test
Un INSERT ... SELECT da una serie crea tutte le righe che ti servono in una sola istruzione:
La tabella riceve 1.000 utenti distribuiti su 30 giorni di iscrizione. I valori sono calcolati da i, quindi ogni esecuzione dà lo stesso risultato; usa random() quando vuoi che cambino. Allo stesso modo puoi generare un milione di righe per provare un indice e confrontare i piani con EXPLAIN ANALYZE.
Numerare le righe e usare le serie nei join
WITH ORDINALITY aggiunge una colonna con la posizione a qualsiasi funzione che restituisce un insieme:
Questo elenca cinque fasce da 15 minuti dalle 09:00 alle 10:00, numerate da 1 a 5. Una serie funziona anche in un CROSS JOIN, per esempio per abbinare ogni utente a ogni giorno di un mese.
Anche generate_series nella lista della SELECT restituisce più righe, ma due chiamate di lunghezza diversa completano la più corta con dei NULL. Tieni le funzioni che restituiscono insiemi in FROM. Per le serie che una sola funzione non può esprimere, come percorrere un albero, usa una CTE ricorsiva.
Domande frequenti
generate_series include il valore finale?
Sì, quando i passi ci arrivano esattamente: generate_series(1, 5) restituisce da 1 a 5. Quando non ci arrivano, la serie si ferma all'ultimo valore che non supera la fine, quindi generate_series(1, 10, 4) restituisce 1, 5 e 9.
MySQL ha generate_series?
No. In MySQL una serie si costruisce con una CTE ricorsiva (WITH RECURSIVE), che funziona anche in PostgreSQL ma è più lunga da scrivere.
Perché generate_series con le date restituisce timestamp?
Non esiste una versione della funzione per date, quindi PostgreSQL usa quella per timestamptz. Riconverti ogni valore con ::date.
Come genero un numero casuale per ogni riga?
Chiama random() nella lista della SELECT: SELECT i, random() FROM generate_series(1, 5) AS i dà un valore tra 0 e 1 per ogni riga, e floor(random() * 100)::int un intero da 0 a 99. Da PostgreSQL 17, random(1, 100) restituisce direttamente un intero casuale in quell'intervallo.