GIN & GiST
Previsualizações de full-text, JSONB, arrays e geoespaciais. Padrões práticos de PostgreSQL para consultas de produção.
Receita
CREATE INDEX profiles_gin ON app.profiles USING gin (attrs jsonb_path_ops);Quando usar este padrão: Este padrão aparece em SQL de aplicação ou de relatórios que você mantém.
Exemplo de Trabalho
EXPLAIN SELECT * FROM app.profiles WHERE attrs @> '{"tier":"pro"}';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 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 de NULL - = NULL é sempre desconhecido. Correção: Use IS NULL ou IS DISTINCT FROM.
- Conversões implícitas - Varreduras sequenciais inesperadas em tipos incompatíveis. Correção: Corresponda os tipos do predicado aos tipos da coluna.
- Consultas ilimitadas - Falta de 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 consulta ORM | A equipe padroniza uma única stack | SQL complexo se torna opaco |
| View materializada | Repetir agregações caras | 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; verifique com lint em CI.
Quando DISTINCT é suficiente?
Quando você precisa de linhas únicas sem agregações.
ORDER BY prejudica os índices?
A ordenação pode usar a ordem do índice se a consulta corresponder às colunas do índice.
Relacionado
- Noções Básicas de Índices - fundamentos
- Noções Básicas de EXPLAIN - planos
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+.