generate_series(start, stop, step) retorna uma linha para cada valor de start até stop, inclusive, andando de step em step (1 se você omitir). Funciona com inteiros, numerics e timestamps com passo do tipo interval. Use no FROM como uma tabela.
Isso retorna 1, 4, 7 e 10 com seus quadrados. Um passo negativo conta para trás: generate_series(5, 1, -2) dá 5, 3, 1. Uma série que não consegue chegar ao fim, como generate_series(5, 1), não retorna linhas. generate_series(0, 1, 0.25) anda com numerics.
Gerar uma série de datas
Passe timestamps ou datas com um passo interval. Não existe versão date, então os valores voltam como timestamptz; converta com ::date:
Voltam cinco dias, de 26 de fevereiro a 2 de março, atravessando a virada do mês. Qualquer intervalo serve como passo: interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week'.
Com valores timestamptz, um passo de interval '1 day' segue o calendário do TimeZone da sessão. Numa mudança de horário de verão, um passo pode ter 23 ou 25 horas. Desde o PostgreSQL 16, um quarto argumento informa o fuso em que a série anda, seja qual for o da sessão:
SELECT generate_series(
timestamptz '2026-03-28 00:00 Europe/Berlin',
timestamptz '2026-03-31 00:00 Europe/Berlin',
interval '1 day',
'Europe/Berlin');
Preencher os dias que faltam num relatório
Um GROUP BY sobre os seus dados só retorna os períodos que têm linhas. Para mostrar todos os dias, com zero nos dias sem pedidos, gere os dias e faça um LEFT JOIN dos dados com eles:
O dia 1º de novembro tem 2 pedidos, o dia 4 tem 1, e os dias 2, 3 e 5 mostram 0. Conte uma coluna da tabela do join (count(o.id)), não count(*), senão cada dia vazio conta como 1.
Comparar created_at com um intervalo, em vez de created_at::date = d, permite usar um índice em created_at. O mesmo padrão com interval '1 month' e date_trunc preenche meses vazios (veja funções de data).
Gerar dados de teste
Um INSERT ... SELECT a partir de uma série cria quantas linhas você precisar numa única instrução:
A tabela recebe 1.000 usuários espalhados por 30 dias de cadastro. Os valores são calculados a partir de i, então toda execução dá o mesmo resultado; use random() quando quiser que variem. Gere um milhão de linhas do mesmo jeito para testar um índice e comparar planos com EXPLAIN ANALYZE.
Numerar as linhas e usar séries em joins
WITH ORDINALITY adiciona uma coluna de posição a qualquer função que retorna um conjunto:
Isso lista cinco faixas de 15 minutos das 09:00 às 10:00, numeradas de 1 a 5. Uma série também funciona num CROSS JOIN, por exemplo para combinar cada usuário com cada dia de um mês.
generate_series na lista do SELECT também retorna várias linhas, mas duas chamadas assim com tamanhos diferentes completam a mais curta com NULLs. Mantenha funções que retornam conjuntos no FROM. Para séries que uma única função não consegue expressar, como percorrer uma árvore, use uma CTE recursiva.
Perguntas frequentes
O generate_series inclui o valor final?
Inclui, quando os passos caem nele: generate_series(1, 5) retorna de 1 a 5. Quando não caem, a série para no último valor que não passa do fim, então generate_series(1, 10, 4) retorna 1, 5 e 9.
O MySQL tem generate_series?
Não. No MySQL você monta uma série com uma CTE recursiva (WITH RECURSIVE), que também funciona no PostgreSQL, mas é mais longa de escrever.
Por que o generate_series com datas retorna timestamps?
Não existe uma versão date da função, então o PostgreSQL usa a de timestamptz. Converta cada valor de volta com ::date.
Como gerar um número aleatório para cada linha?
Chame random() na lista do select: SELECT i, random() FROM generate_series(1, 5) AS i dá um valor entre 0 e 1 por linha, e floor(random() * 100)::int um inteiro de 0 a 99. Desde o PostgreSQL 17, random(1, 100) retorna direto um inteiro aleatório nesse intervalo.