Partition Table

Particionamento declarativo divide uma tabela grande em tabelas menores por faixa de data, dentro do mesmo servidor. A aplicação continua lendo e gravando em transactions; o PostgreSQL roteia cada linha para o mês certo e, numa consulta limitada por data, lê só as partições que importam. É o primeiro passo antes de pensar em sharding.

passos: 6
arquivos: 6
teste: 1
tecnologias: 4

Infraestrutura realTypeScriptBunPostgreSQLDocker

Cenário Relações Comparar

Baixar cartão

Cenário

Core bancário com o livro de lançamentos crescendo milhões de linhas por mês. O extrato mensal de uma conta precisa ler só aquele mês, e a retenção regulatória manda tirar do banco online o que passou de 12 meses — sem um DELETE que varre a tabela, incha o disco e inunda o WAL.

Planta

Fluxo

8/8

8 passos — reproduza para seguir o fluxo

chamada
resposta ou assíncrono
falha
passo
toque num nó para focar
Outras plantas de fluxo

Como funciona

6 passos

Tabela dividida por faixa de data.

Esconde cada passo: lembre antes de tocar para revelar.

Vocabulário compartilhado

created_at+1

Event Sourcing

01
transactions é particionada por RANGE (created_at); a chave primária inclui created_at, exigência do particionamento
02
A manutenção cria as partições dos próximos meses antes de chegarem, como faz o pg_partman
03
O insert não cita partiçãoO banco roteia pelo mês; o limite inferior pertence à partição e o superior à seguinte
04
O extrato filtra por mês e o planner poda as outras partições
05
Linha na partição default é alertaAquele mês não foi criado, e a partição dele já não pode ser criada depois
06
Retenção por DDLO mês vencido sai com DETACH e DROP (arquivado antes, em produção)

Trade-offs

O que se ganha, o que se paga

3 vantagenscada ganho tem um preço3 custos

Vantagens

Consulta por data lê só o mês
Retenção instantânea, sem DELETE
Índices menores por partição

Custos

Consulta sem a data lê todas as partições
Chave primária e únicas precisam incluir created_at
Exige job de manutenção das partições

apps/data-patterns/partition-table

6 arquivos

sql/

01_schema.sqlschemaTabela particionada, índice e partição default

src/

maintenance_partition.tsCriação adiantada, retenção e contagem da default
statement_account.tsExtrato mensal podado e seed
demo.tsdemoCriação, roteamento, poda e retenção
maintenance_partition.test.tstesteIdempotência, limites, poda, armadilha da default e retenção contra PostgreSQL real

src/config_partition.ts / src/