Constraints CHECK & UNIQUE
Aplique regras próximas aos dados. Padrões práticos de PostgreSQL para consultas de produção.
Receita
ALTER TABLE app.accounts ADD CONSTRAINT accounts_name_len CHECK (char_length(name) <= 200);
CREATE UNIQUE INDEX accounts_name_active_unique ON app.accounts (name) WHERE deleted_at IS NULL;Quando usar isso: Este padrão aparece em SQL de aplicação ou de relatórios que você mantém.
Exemplo de Trabalho
INSERT INTO app.accounts (name) VALUES ('Acme'); -- o segundo 'Acme' falha enquanto ativoO que isso demonstra:
- SQL executável contra esquemas de exemplo
- Sintaxe idiomática do 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 os 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.
- Conversões implícitas - Varreduras seq. inesperadas 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 | Usar Quando | Não Usar Quando |
|---|---|---|
| Construtor de consultas ORM | A equipe padroniza em uma stack | SQL complexo se torna opaco |
| View materializada | Agregados caros repetidos | Necessita de estratégia de atualização |
| Réplica de Data Warehouse | Varreduras pesadas 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 Design de Esquema - nomenclatura e chaves
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+.