As operações escolhidas para a consulta
O plano de execução é a sequência de operações escolhida pelo banco para executar uma instrução SQL. Ele descreve como acessar as tabelas e combinar seus registros, incluindo etapas de filtragem ou ordenação necessárias para produzir o resultado.
No PostgreSQL, o comando EXPLAIN apresenta esse plano como uma árvore. As etapas mais internas fornecem registros às etapas que dependem delas. Para escolher o acesso, o planejador usa estatísticas das tabelas e custos configurados no banco, portanto suas estimativas podem divergir do que a execução encontra.
A leitura das assinaturas ativas
O exemplo didático pressupõe uma tabela assinaturas com a coluna situacao. A instrução abaixo solicita o plano estimado da consulta, sem retornar a lista de assinaturas:
EXPLAIN SELECT * FROM assinaturas WHERE situacao = 'ativa';Uma saída possível contém Seq Scan on assinaturas e um Filter correspondente à situação ativa. O banco planeja percorrer a tabela e testar o filtro nas linhas lidas. Essa estratégia pode ter custo menor quando a tabela é pequena ou quando grande parte dos registros corresponde ao filtro.
Você também encontrará estimativas como rows, para o número de linhas produzidas pela etapa, e cost, para o custo previsto. Esses valores dependem da tabela consultada. Um Seq Scan isolado não demonstra que falta um índice ou que a consulta está lenta.
O que muda com EXPLAIN ANALYZE
A opção ANALYZE executa a instrução e acrescenta medições ao plano. Você pode comparar as linhas estimadas com as observadas e examinar o tempo das etapas em milissegundos. O campo cost continua expresso nas unidades do planejador, por isso seu valor não deve ser lido como duração.
Em instruções de escrita, EXPLAIN ANALYZE também realiza as alterações solicitadas. Um teste com UPDATE, por exemplo, modifica os registros alcançados pela instrução. A coleta das medições ainda acrescenta trabalho à execução, o que precisa ser considerado ao comparar tempos.
O tempo de execução no banco cobre apenas parte da espera percebida na aplicação. Para investigar a demora completa, confira também o tempo de transmissão do resultado e o processamento realizado fora da consulta.
Dúvidas frequentes
Perguntas frequentes sobre plano de execução
- O custo do plano é medido em milissegundos?
- No PostgreSQL, o campo cost usa unidades do planejador para comparar estratégias. Com ANALYZE, o plano também apresenta tempos medidos em milissegundos, em campos separados.
- EXPLAIN ANALYZE executa a instrução?
- Sim. A instrução é executada para coletar medições. Um UPDATE com EXPLAIN ANALYZE altera os registros, mesmo que a finalidade seja investigar seu desempenho.
- Uma leitura sequencial indica defeito?
- Não necessariamente. Percorrer a tabela pode ser apropriado quando a consulta retorna muitas linhas ou a tabela é pequena. O resultado depende da consulta e das condições do banco.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: leitura do EXPLAIN
Explica a árvore de operações, as estimativas de linhas e a comparação com medições de execução.
Abrir recursoSite de referência
Desenvolvimento Colaborativo da Dev Side Studio
Sessão ao vivo para investigar uma consulta do seu sistema, com você operando o editor e o terminal.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A leitura do plano permite investigar uma consulta do sistema e conferir o acesso às tabelas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.