Criar uma tabela particionada por range mensal (gerar as partições em um loop)

Comando

CREATE TABLE sales (
  id         bigint GENERATED ALWAYS AS IDENTITY,
  created_at      date   NOT NULL,
  customer_id bigint NOT NULL,
  amount      numeric(12,2),
  PRIMARY KEY (id, created_at)
) PARTITION BY RANGE (created_at);

-- An index defined on the parent propagates to all partitions automatically
CREATE INDEX sales_customer_id_idx ON sales (customer_id);

-- 12 monthly partitions for 2026
DO $$
DECLARE
  m date;
BEGIN
  FOR m IN SELECT generate_series(date '2026-01-01', date '2026-12-01', interval '1 month')::date LOOP
    EXECUTE format(
      'CREATE TABLE IF NOT EXISTS %I PARTITION OF sales FOR VALUES FROM (%L) TO (%L)',
      'sales_' || to_char(m, 'YYYY_MM'), m, (m + interval '1 month')::date);
  END LOOP;
END $$;

-- Hierarchy, bounds and sizes
SELECT t.relid::regclass AS partition_name,
       t.parentrelid::regclass AS parent,
       t.isleaf,
       t.level,
       pg_get_expr(c.relpartbound, c.oid) AS bounds,
       pg_size_pretty(pg_total_relation_size(t.relid)) AS total_size
FROM pg_partition_tree('sales') t
JOIN pg_class c ON c.oid = t.relid
ORDER BY t.level, bounds;

O que faz

Cria uma tabela pai particionada por RANGE em uma coluna de data, um índice que se propaga a todas as partições e 12 partições mensais em um loop; depois lista a hierarquia com limites e tamanhos.

Quando usar

Para tabelas grandes e em crescimento contínuo que descartam dados antigos periodicamente (DETACH/DROP) ou cujas consultas filtram principalmente por intervalo de datas (pedidos, logs, séries temporais).

Atenção

Em uma tabela particionada, as constraints PRIMARY KEY/UNIQUE devem incluir a chave de partição (não há índices unique globais). O limite inferior é inclusivo e o superior exclusivo (FROM inclusivo, TO exclusivo). Sem um job que crie antecipadamente as partições futuras (pg_cron, pg_partman), INSERTs fora do intervalo falham. Milhares de partições aumentam o tempo de planejamento e o overhead de locks. CREATE INDEX CONCURRENTLY não é suportado na tabela pai: use CREATE INDEX ... ON ONLY no pai, CREATE INDEX CONCURRENTLY em cada partição e depois ALTER INDEX ... ATTACH PARTITION.