UUID, Enum & Tipos de Domínio
Quando enums ajudam e quando tabelas de consulta vencem. Padrões práticos de PostgreSQL para consultas de produção.
Receita
CREATE TYPE app.status AS ENUM ('pending','active','closed');
CREATE DOMAIN app.positive_int AS int CHECK (VALUE > 0);Quando usar isso: Este padrão aparece em SQL de aplicação ou de relatórios que você mantém.
Exemplo de Trabalho
CREATE TABLE app.cases (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
status app.status NOT NULL DEFAULT 'pending',
priority app.positive_int NOT NULL
);O que isso demonstra:
- SQL executável contra esquemas de exemplo
- Sintaxe idiomática de PostgreSQL
- Padrões seguros para revisão com EXPLAIN
Mergulho Profundo
Como Funciona
- O PostgreSQL analisa o SQL em uma árvore de consulta.
- O planejador estima custos usando estatísticas.
- O executor retorna linhas para o protocolo do cliente.
Notas
- Prefira SQL legível; otimizadores reescrevem internamente.
- Teste com contagens de linhas semelhantes à produção.
Armadilhas
- SELECT * em aplicativos - Novas colunas quebram serializadores. Correção: Liste as colunas explicitamente.
- Comparações NULL - = NULL é sempre desconhecido. Correção: Use IS NULL ou IS DISTINCT FROM.
- Casts implícitos - Scans sequenciais surpreendentes em tipos incompatíveis. Correção: Combine os tipos do predicado com os tipos da coluna.
- Consultas ilimitadas - Falta LIMIT em tabelas grandes. Correção: Paginar ou agregar intencionalmente.
- Estatísticas desatualizadas - Planos ruins após carga em massa. Correção: Execute ANALYZE nas tabelas afetadas.
Alternativas
| Alternativa | Use Quando | Não Use Quando |
|---|---|---|
| Construtor de consultas ORM | A equipe padroniza em uma stack | SQL complexo se torna opaco |
| Visão materializada | Repete agregações caras | Necessita de estratégia de atualização |
| Réplica de Data Warehouse | Scans pesados de BI | Não para latência OLTP |
FAQs
Devo formatar SQL em strings de aplicativo?
Use strings de template multilinhas ou arquivos SQL; faça lint em CI.
Quando DISTINCT é suficiente?
Quando você precisa de linhas únicas sem agregações.
ORDER BY prejudica índices?
A ordenação pode usar a ordem do índice se a consulta corresponder às colunas do índice.
Relacionado
- Noções Básicas de Tipos de Dados - visão geral
Versões da 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+.