Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é plano de execução?

    O plano de execução descreve como o banco acessa e combina registros de uma consulta. No PostgreSQL, o EXPLAIN apresenta etapas e custos estimados.

    Também chamado de: query plan, execution plan, plano de consulta

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano