Melhores Práticas de Estatísticas

A qualidade do planejador depende de estatísticas atualizadas. Trate ANALYZE como parte de toda migração de dados e revisão de performance no PostgreSQL 18.4.

Como Usar Esta Lista

• Execute após DML em massa antes de indexar benchmarks.
• Combine com verificações de linhas estimadas vs. reais do EXPLAIN.
• Documente estatísticas estendidas em PRs de migração quando adicionadas.

A - Cadência de Atualização

• ANALYZE manual após COPY em massa, purgas de exclusão ou backfills. O autoanalyze pode ter um atraso de horas.
• Analise novas partições quando anexadas. Estatísticas vazias enganam a poda.
• Reanalise após CREATE INDEX CONCURRENTLY em tabelas enormes. Confirme que o planejador o seleciona.
• Monitore n_mod_since_analyze em tabelas quentes. Alerte antes que os planos se deteriorem.
• Inclua a etapa de análise nos runbooks de ETL. Último job antes da abertura do BI.

B - Profundidade e Correlação

• Aumente o alvo de STATISTICS apenas em colunas com distribuição comprovadamente enviesada. Não globalmente por padrão.
• Adicione estatísticas estendidas para filtros AND correlacionados. dependências ou ndistinct, conforme apropriado.
• Crie estatísticas de expressão para predicados de relatórios imutáveis. date_trunc, lower onde indexado.
• Valide com pg_stats e EXPLAIN antes/depois. Prove as correções de estimativa.
• Remova estatísticas estendidas não utilizadas para encurtar a análise. Auditoria periódica do catálogo.

C - Segurança Operacional

• Nunca desabilite autovacuum/analyze globalmente. Ajuste por tabela em vez disso.
• Agende analyze pesado fora do horário de pico, quando possível. Tabelas grandes ainda são amostradas intensamente.
• Mantenha estatísticas em repositórios de migração lógicos. CREATE STATISTICS é um esquema.
• Teste planos como roles de aplicação com GUCs de produção. random_page_cost em nível de role importa.
• Snapshot de dados mascarados em escala de produção para revisão de planos. Bancos de dados de desenvolvimento vazios mentem.

D - Processo da Equipe

• Rejeite PRs de índice sem planos pós-análise. Evite falsos negativos.
• Rastreie regressões de planos em CI com baselines JSON EXPLAIN. Detecção de deriva de estatísticas.
• Documente suposições de enviesamento de tenant em ADRs. Pares de índices parciais mais estatísticas.
• Treine equipes de aplicação: deploy de ORM != análise. Alteração de dados aciona notificação do DBA.
• Revise pg_stat_user_tables mensalmente nas 20 principais tabelas. Higiene operacional.

FAQs

Relacionados

• Noções Básicas de Estatísticas - Fundamentos do catálogo
• ANALYZE & Autoanalyze - Timing
• Estatísticas Estendidas - Ferramentas de correlação
• Melhores Práticas de EXPLAIN - Captura de plano

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