Noções Básicas de Séries Temporais

Cargas de trabalho de séries temporais no PostgreSQL beneficiam de particionamento por intervalo em timestamps, índices BRIN para varreduras somente de adição (append-only) e políticas de retenção que desanexam ou descartam partições antigas. O particionamento nativo cobre muitos casos de uso de métricas antes do TimescaleDB.

Receita

CREATE TABLE metrics (
  device_id   int NOT NULL,
  ts          timestamptz NOT NULL,
  value       double precision NOT NULL
) PARTITION BY RANGE (ts);
 
CREATE TABLE metrics_2026_07 PARTITION OF metrics
  FOR VALUES FROM ('2026-07-01') TO ('2026-08-01');
 
CREATE INDEX metrics_2026_07_device_ts ON metrics_2026_07 (device_id, ts DESC);
 
-- BRIN para partições grandes somente de adição (complemento opcional)
CREATE INDEX metrics_2026_07_ts_brin ON metrics_2026_07 USING brin (ts);

Quando usar isso: Inserções de alto volume com consultas limitadas por tempo (dashboards, IoT, métricas de auditoria) onde varreduras sequenciais em uma única tabela gigante estão falhando.

Exemplo de Trabalho

INSERT INTO metrics (device_id, ts, value)
SELECT (random() * 100)::int,
       timestamptz '2026-07-01' + (g * interval '1 minute'),
       random()
FROM generate_series(0, 10000) g;
 
EXPLAIN (ANALYZE, BUFFERS)
SELECT date_trunc('hour', ts) AS hour,
       avg(value) AS avg_value
FROM metrics
WHERE ts >= timestamptz '2026-07-08'
  AND ts <  timestamptz '2026-07-09'
  AND device_id = 42
GROUP BY 1
ORDER BY 1;
 
-- Retenção: descartar partição do mês anterior
DROP TABLE IF EXISTS metrics_2025_01;

O que isso demonstra:

• O particionamento (partition pruning) limita os dados escaneados à tabela filha de julho de 2026.
• O índice composto (device_id, ts DESC) suporta filtro + intervalo de tempo.
• BRIN opcional para partições muito grandes com heap correlacionado ao tempo.
• DROP TABLE em uma partição é uma retenção rápida em comparação com DELETE de milhões de linhas.

Mergulho Profundo

Estratégia de Particionamento

-- Criar partição do próximo mês (automatizar em produção)
CREATE TABLE metrics_2026_08 PARTITION OF metrics
  FOR VALUES FROM ('2026-08-01') TO ('2026-09-01');

BRIN em Timestamps

BRIN se destaca quando as linhas estão fisicamente correlacionadas com ts (somente adição). Tamanho de índice minúsculo em comparação com B-tree.

CREATE INDEX ON metrics_2026_07 USING brin (ts) WITH (pages_per_range = 128);

Combine BRIN com particionamento: cada partição mensal recebe seu próprio BRIN.

B-tree vs BRIN

Frequentemente usa-se ambos: btree em (device_id, ts) para pontos/intervalos por dispositivo, BRIN em ts para agregações amplas, se necessário.

Disciplina Timestamptz

-- Sempre use timestamptz para séries (nunca timestamp sem fuso horário)
ALTER TABLE metrics ALTER COLUMN ts TYPE timestamptz USING ts AT TIME ZONE 'UTC';

Armazene em UTC; converta na aplicação para exibição.

Armadilhas

• Partição padrão "catch-all" - Tudo vai para DEFAULT, o particionamento falha. Correção: Monitore os limites das partições; alerte antes que DEFAULT encha.
• Retenção com DELETE - Deletar milhões de linhas incha a tabela e o WAL. Correção: DROP PARTITION ou DETACH + arquivar.
• Partição futura ausente - Inserções falham na virada do mês. Correção: Automatize a criação de partições com 2 meses de antecedência.
• timestamp sem fuso horário - Bugs de DST em agregações. Correção: Use apenas timestamptz; veja o artigo sobre cenários de defeitos.
• BRIN com ordem de inserção aleatória - BRIN inútil se o heap não estiver correlacionado. Correção: Padrão de carga somente de adição ou pule BRIN.
• Índice global na tabela pai - Não é possível criar índice único em todas as partições sem inclusão da chave de partição (regras PG 11+). Correção: Inclua ts em chaves únicas.

Alternativas

FAQs

Relacionados

• Noções Básicas de Particionamento - particionamento nativo
• BRIN - índices de intervalo de blocos
• TimescaleDB - extensão hypertables
• Melhores Práticas de Séries Temporais - retenção como código
• ADR de Offload OLAP - quando sair do Postgres

Versões da Stack: Esta página foi escrita para PostgreSQL 18.4 (estável 18, manutenção 17), pgvector 0.8+, PostGIS 3.5+, pgbouncer 1.x e Patroni 3.x.