Melhores Práticas de Manutenção de Índices

Índices são contratos que geram escritas. Mantenha-os com evidências de planos, estatísticas de uso e métricas de inchaço no PostgreSQL 18.4.

Como Usar Esta Lista

• Exija prova de EXPLAIN em PRs de índice.
• Revise idx_scan trimestralmente em tabelas com muitas escritas.
• Emparelhe alterações de índice com ANALYZE na mesma janela de alteração.

A - Portões de Design

• Mapeie o índice para uma forma de consulta específica no ticket. Sem índices especulativos.
• Prefira índices compostos a muitos índices de coluna única. Reduza a amplificação de escrita.
• Coloque colunas de igualdade antes de colunas de intervalo em compostos. Disciplina de prefixo esquerdo.
• Use índices parciais para predicados seletivos estáveis. Menores, mais rápidos, escritas mais baratas.
• Evite indexar booleanos de baixa cardinalidade sozinhos. A menos que o predicado parcial seja uma fatia pequena.

B - Operações

• Use CREATE INDEX CONCURRENTLY em migrações de produção. Evite longos blocos de escrita.
• Execute ANALYZE após a criação do índice em tabelas grandes. Verificação de adoção do planejador.
• Monitore pg_stat_user_indexes.idx_scan antes de descartar. Limpeza baseada em evidências.
• REINDEX CONCURRENTLY quando o inchaço for comprovado, não apenas por agendamento. Reconstruções direcionadas.
• Acompanhe o crescimento do tamanho do índice versus o tamanho da tabela. Detecção precoce de inchaço.

C - Fluxo de Trabalho da Equipe

• Documente solicitações de índice rejeitadas com EXPLAIN. Evite debates repetidos.
• Audite prefixos redundantes após adições compostas. Descarte índices substituídos.
• Inclua DROP CONCURRENTLY de reversão na migração. Caminho seguro de reversão.
• Teste de carga de escritas após pacotes de índice. Meça o impacto do p95 de inserção.
• Alinhe com os padrões de revisão de consulta para texto SQL. SQL oculto por ORM ainda é revisado.

D - Anti-Padrões

• Não indexe cegamente todas as chaves estrangeiras se não forem usadas. Indexe junções filhas que você executa.
• Não duplique a restrição UNIQUE com INDEX simples. Desordem no catálogo.
• Não adicione GIN em JSONB sem consultas de contenção. Custo de manutenção enorme.
• Não corrija varreduras sequenciais com índices antes de ANALYZE. Estatísticas primeiro.
• Não deixe índices INVALID após falha de CONCURRENTLY. Descarte e tente novamente.

FAQs

Relacionados

• Noções Básicas de Design de Índice - Regras de design
• Índices Duplicados e Redundantes - Auditorias
• REINDEX & REINDEX CONCURRENTLY - Reconstruções
• Lidando com Solicitações de Índice - Processo da equipe

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+.