Melhores Práticas de Tipos de Dados

Escolhas de tipos são decisões de esquema com as quais você convive por anos.

Como Usar Esta Lista

• Decida no design da tabela; evite ALTER silencioso que alarga.
• Documente em ADR para dinheiro e fuso horário.

A - Escalares

• Use numeric para dinheiro. Decimais exatos.
• Prefira text sobre varchar a menos que seja restrito. Mesmo desempenho.
• Use bigint para chaves substitutas em escala. Evite overflow.

B - Tempo e IDs

• Use timestamptz para eventos. Armazenamento em UTC.
• Use uuid ou bigint identity para PKs. Escolha um por tabela.
• Evite timestamp without time zone. Tempos locais ambíguos.

C - Semi-estruturados

• Use jsonb para facetas opcionais. Não a entidade inteira.
• Use GIN apenas para caminhos de consulta comprovados. O custo do índice é real.
• Use CHECK jsonb_typeof quando a forma importa. Capture escritas ruins cedo.

FAQs

Relacionados

• Noções Básicas de Tipos de Dados - tour
• Melhores Práticas de Design de Esquema - restrições

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