0Pricing
SQL Academy · Aula

pg_stat_statements: principais consultas

Habilite pg_stat_statements, encontre as consultas mais pesadas pelo tempo total e priorize-as para otimização.

pg_stat_statements: principais consultas é uma aula grátis de SQL Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de SQL Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de SQL Academy inclui 4 aulas no total.

O que pg_stat_statements fornece

Um registro acumulado de cada consulta, normalizado por formato — a ferramenta de DBA mais útil do PostgreSQL.

Ative-o

É uma extensão contrib. Adicione-a a shared_preload_libraries e reinicie:

-- postgresql.conf
shared_preload_libraries = 'pg_stat_statements'

-- After restart:
CREATE EXTENSION pg_stat_statements;

Principais consultas por tempo total

A consulta "para onde está indo minha CPU":

SELECT calls,
       total_exec_time,
       mean_exec_time,
       rows,
       query
FROM pg_stat_statements
ORDER BY total_exec_time DESC
LIMIT 10;

Consultas lentas em cada chamada

Consultas que são lentas em todas as chamadas:

SELECT mean_exec_time, calls, query
FROM pg_stat_statements
WHERE mean_exec_time > 100
ORDER BY mean_exec_time DESC
LIMIT 20;

Consultas frequentes e baratas

Um milhão de consultas de 1 ms ainda é um problema:

SELECT calls, mean_exec_time, total_exec_time, query
FROM pg_stat_statements
ORDER BY calls DESC
LIMIT 20;

Normalização

pg_stat_statements agrupa consultas por formato normalizado — os literais são substituídos por $N. Assim, "SELECT * FROM users WHERE id = 1" e "= 2" se tornam a mesma linha.

Redefinição das estatísticas

Comece do zero após uma implantação para medir o novo comportamento:

SELECT pg_stat_statements_reset();

Tempo de E/S versus CPU

As versões mais recentes do PG separam o tempo de execução. shared_blks_hit / shared_blks_read indicam o uso do cache ou do disco:

SELECT query, shared_blks_hit, shared_blks_read,
       shared_blks_read::FLOAT / NULLIF(shared_blks_hit + shared_blks_read, 0) AS read_ratio
FROM pg_stat_statements
ORDER BY shared_blks_read DESC LIMIT 20;

JIT e tempo de planejamento

O PG 13+ expõe total_plan_time. Algumas consultas passam mais tempo em PLANNING do que em execução — geralmente um sinal de que se deve usar instruções preparadas.

Estatísticas por banco de dados / por usuário

pg_stat_statements abrange todo o cluster. Filtre pelas colunas dbid e userid para obter exibições por banco de dados / por usuário.

Combinação com EXPLAIN ANALYZE

pg_stat_statements informa WHICH consultas estão lentas. EXPLAIN ANALYZE informa WHY.

Ressalvas

  • O acúmulo separado por banco de dados e por usuário pode ocultar problemas — examine o total
  • Não acompanha o tempo por linha, apenas o total por chamada
  • É redefinido ao reiniciar ou ao chamar a redefinição

Resumo

pg_stat_statements é obrigatório em produção.

  • Principais por tempo total → maiores ganhos
  • Principais pela média → lentidão consistente
  • Principais por chamadas → problema de frequência
  • Combine com EXPLAIN para corrigir os problemas

Verificação rápida

Você ativou pg_stat_statements. Qual consulta oferece os maiores ganhos de desempenho para investigação?

Perguntas Frequentes

A aula “pg_stat_statements: principais consultas” é grátis?

Sim — o texto completo de “pg_stat_statements: principais consultas” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de SQL Academy, atualize para CoddyKit PRO. O curso de SQL Academy inclui 4 aulas no total.

O que vou aprender em “pg_stat_statements: principais consultas”?

Habilite pg_stat_statements, encontre as consultas mais pesadas pelo tempo total e priorize-as para otimização. Você pratica SQL Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar SQL Academy?

Nenhuma experiência prévia é necessária. SQL Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “pg_stat_statements: principais consultas”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de SQL Academy?

Sim. Cada aula de SQL Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. pg_stat_statements: principais consultas
  2. pgBadger para análise de registros
  3. Agrupamento de conexões: PgBouncer
  4. Planejamento de capacidade e auditorias de fragmentação
← Voltar para SQL Academy