// ferramenta gratuita

Visualizador de plano de consulta

Cole um plano de execução do SQL Server, PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse ou Oracle e veja o que está lento, por quê e o que mudar - resultados classificados, uma árvore de operadores e um diagrama do plano. É o leitor de plano do aplicativo desktop SQLly compilado para WebAssembly, então ele roda no seu navegador e seu plano nunca sai do seu dispositivo.

Loading the plan reader…

Dica: pressione Ctrl+Enter (⌘+Enter no Mac) na caixa para analisar. Os arquivos são lidos neste dispositivo com o leitor de arquivos do seu navegador; nada é enviado.

O que este visualizador de plano de execução faz

Um plano de consulta é a resposta do banco de dados a «como você vai executar isto?» - quais índices ele lê, como faz as junções, quantas linhas espera em cada etapa e para onde vai o custo. Planos são densos, e cada mecanismo os escreve de um jeito diferente. Este visualizador lê todos num modelo único e começa pelo que importa: uma lista de problemas em linguagem simples, do mais grave ao menos, cada um com o motivo de doer e um próximo passo concreto.

  • Primeiro os achados. Varreduras completas, índices ausentes, conversões implícitas, key lookups, spills, estatísticas ausentes, cross joins, row goals e erros de estimativa de linhas - do pior para o melhor, com o operador ao qual pertencem e, para as sugestões de índice ausente do SQL Server, uma pronta para revisão CREATE INDEX instrução.
  • Oito mecanismos, uma visão. SQL Server, PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse e Oracle leem os planos da mesma forma, então você não precisa de uma ferramenta diferente para cada banco de dados.
  • Árvore e diagrama. A árvore de operadores mostra lado a lado a participação no custo, as linhas estimadas e as linhas reais de cada etapa, com desvios de 10× ou mais destacados. O diagrama dispõe o plano de cima para baixo, com barras de custo que você lê num relance.
  • Lotes e saída colada. Planos de SQL Server com várias instruções ganham um seletor de instruções. A saída copiada do psql, do cliente mysql ou do sqlplus já vem desembrulhada para você — não é preciso remover bordas nem + continuações primeiro.
  • Privado. Toda a análise roda na sua aba. Os planos carregam o seu SQL, nomes de tabelas e, às vezes, valores de parâmetros; nada disso é enviado.

Como obter um plano de execução de cada banco de dados

Todo mecanismo tem dois tipos de plano. Um estimado plano é a previsão do otimizador e nunca executa a instrução. Um real plano executa a instrução e registra as contagens reais de linhas - o único jeito de ver onde o otimizador errou. A captura real também executa inserções, atualizações e exclusões, então os dados de teste mudam dentro de uma transação que você reverte.

SQL Server e Azure SQL: ShowPlan XML

Plano real - executa a consulta e retorna um documento de plano por instrução, após os resultados:

SET STATISTICS XML ON;
SELECT ... ;   -- your query
SET STATISTICS XML OFF;

Plano estimado - compila sem executar. SET SHOWPLAN_XML por isso os GO separadores:

SET SHOWPLAN_XML ON;
GO
SELECT ... ;   -- your query
GO
SET SHOWPLAN_XML OFF;

No SSMS, ative Incluir Plano de Execução Real (Ctrl+M) ou use Exibir Plano de Execução Estimado (Ctrl+L), depois clique com o botão direito no plano gráfico e escolha Salvar plano de execução como… para obter um .sqlplan arquivo que você pode abrir aqui, ou Mostrar XML do plano de execução… para copiar o XML. Planos já no cache ou no Query Store também funcionam: sys.dm_exec_query_plan(plan_handle) retorna o XML, e sys.query_store_plan.query_plan mantém como texto. Se você copiar um plano grande da grade de resultados do SSMS e o visualizador informar XML incompleto, a grade o truncou (seu limite de XML está configurado em Ferramentas > Opções > Resultados de Consulta > SQL Server > Resultados para Grade); salve o plano como um arquivo em vez disso.

PostgreSQL: EXPLAIN (FORMAT JSON)

-- Actual plan: runs the query
EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) SELECT ... ;

-- Estimated plan: does not run it
EXPLAIN (FORMAT JSON) SELECT ... ;

-- Measure a data change without keeping it
BEGIN;
EXPLAIN (ANALYZE, FORMAT JSON) UPDATE ... ;
ROLLBACK;

O visualizador lê o formato JSON, não a saída de texto padrão do PostgreSQL. Colar direto do psql funciona - o QUERY PLAN cabeçalho e o + no final de cada linha são removidos - ou execute psql -XqAt -c "EXPLAIN (ANALYZE, FORMAT JSON) ..." para uma saída limpa. Para planos de consultas executadas pelo seu aplicativo, o auto_explain módulo pode registrá-los com auto_explain.log_format = json.

MySQL: EXPLAIN FORMAT=JSON e EXPLAIN ANALYZE

-- Estimated plan as JSON: does not run the query
EXPLAIN FORMAT=JSON SELECT ... ;

-- Actual plan (MySQL 8.0.18 and later): runs the query
EXPLAIN ANALYZE SELECT ... ;

Ambos são lidos, e o visualizador os diferencia pela forma. As bordas de tabela do cliente mysql, \G banners de linha e rodapés “1 row in set” são removidos ao colar. Versões mais recentes do MySQL também podem emitir um segundo layout JSON (explain_json_format_version = 2); o visualizador lê o original, então execute SET explain_json_format_version = 1; primeiro se o seu servidor padrão for a versão 2.

MariaDB: EXPLAIN e ANALYZE FORMAT=JSON

-- Estimated plan: does not run the query
EXPLAIN FORMAT=JSON SELECT ... ;

-- Actual plan with r_rows, r_loops and timings: runs the query
ANALYZE FORMAT=JSON SELECT ... ;

SQLite: EXPLAIN QUERY PLAN

EXPLAIN QUERY PLAN SELECT ... ;

O SQLite nunca executa a instrução para EXPLAIN QUERY PLAN, e seus planos não têm custos nem estimativas de linhas - apenas os passos, o que ainda é suficiente para identificar um SCAN que deveria ser um SEARCH. O sqlite3 árvore do shell (QUERY PLAN, |--, `--) é lido como está, e o mesmo vale para os brutos. id | parent | notused | detail linhas que outras ferramentas retornam. No shell, .eqp on imprime o plano antes de cada instrução que você executar.

DuckDB: EXPLAIN (FORMAT JSON)

-- Estimated plan
EXPLAIN (FORMAT JSON) SELECT ... ;

-- Actual plan with per-operator rows and timing: runs the query
EXPLAIN (ANALYZE, FORMAT JSON) SELECT ... ;

Cole o JSON da explain_value coluna. O DuckDB não tem unidades de custo, então um plano real colore os operadores pelo tempo que eles levaram.

ClickHouse: EXPLAIN json = 1

EXPLAIN json = 1, indexes = 1
SELECT ...
FORMAT TSVRaw;

indexes = 1 adiciona quantas partes e grânulos cada chave primária, chave de partição e índice de salto manteve; é assim que o visualizador identifica uma leitura que não eliminou nada. FORMAT TSVRaw retorna o JSON sem escape. O ClickHouse não tem EXPLAIN ANALYZE, então seus planos são sempre estimados.

Oracle Database: DBMS_XPLAN

-- Estimated plan: does not run the query
EXPLAIN PLAN FOR SELECT ... ;
SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY);

-- Actual plan: run the query with row-source statistics, then read its cursor
SET SERVEROUTPUT OFF
SET LINESIZE 300
SELECT /*+ GATHER_PLAN_STATISTICS */ ... ;
SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY_CURSOR(NULL, NULL, 'ALLSTATS LAST'));

Cole toda a saída, incluindo a seção de Informações de Predicado - o visualizador anexa cada access e filter predicado à sua operação. DISPLAY_CURSOR precisa de acesso SELECT a V$SESSION, V$SQL, V$SQL_PLAN e V$SQL_PLAN_STATISTICS_ALL, concedido diretamente ao usuário. Mantenha SERVEROUTPUT desativado no SQL*Plus ou SQLcl, caso contrário o “último cursor” que ele mostra será a chamada de saída em vez da sua consulta, e aumente a largura de LINESIZE para que a tabela do plano não quebre linha.

O que cada descoberta significa e como corrigi-la

Os achados são classificados por gravidade e depois pela participação do operador no custo da instrução, então o primeiro cartão costuma ser o problema mais caro que você pode corrigir. Cada um indica o operador de onde veio - selecione-o para pular até ele na árvore.

Índice ausente

O que isso significa. Enquanto compilava a instrução, o SQL Server determinou um índice que teria tornado a execução mais barata e o registrou no plano com uma melhoria estimada. O visualizador relata isso uma vez, no operador que lê essa tabela, e o transforma em uma instrução CREATE NONCLUSTERED INDEX instrução. Sugestões com impacto estimado de 90% ou mais são marcadas como críticas.

Como corrigir isso. Trate a instrução como um rascunho. O otimizador lista colunas de igualdade, depois colunas de desigualdade, depois colunas incluídas, sem verificar os índices que você já tem - um índice existente muitas vezes pode ser ampliado em vez de adicionar um quase duplicado, e todo índice desacelera as escritas. Verifique se a ordem das colunas-chave serve às suas outras consultas, crie o índice e capture o plano de novo. Esta recomendação vem apenas de planos do SQL Server; outros mecanismos não registram sugestões de índice.

Varredura completa da tabela

O que isso significa. O operador lê cada linha de uma tabela (ou de um índice inteiro) para encontrar as que precisa. O visualizador sinaliza varreduras de tabela e varreduras de índice do SQL Server com um predicado residual, PostgreSQL Seq Scan, MySQL e MariaDB access_type: ALL e Table scan on, SQLite SCAN etapas sem um índice, varreduras do DuckDB sem filtro aplicado, leituras do ClickHouse cujos índices não eliminaram nenhum grânulo, e Oracle TABLE ACCESS FULL.

Como corrigir isso. Uma varredura é a escolha certa para tabelas pequenas e para consultas que precisam da maioria das linhas. Quando o filtro é seletivo, adicione um índice nas colunas filtradas ou usadas nas junções, e garanta que o predicado consiga usá-lo: nenhuma função envolvendo a coluna (WHERE lower(email) = ... precisa de um índice de expressão no PostgreSQL), nenhum curinga no início em LIKE '%x', e tipos de dados correspondentes. No ClickHouse, filtre com base em um prefixo da tabela ORDER BY chave ou adicione um índice de salto.

Desvio na estimativa de linhas

O que isso significa. Um plano real leu pelo menos 10× mais ou menos linhas do que o otimizador estimou para aquele operador. Cada escolha seguinte - tipo de junção, ordem de junção, concessão de memória - foi feita para a quantidade errada de dados, então um grande erro no fundo do plano geralmente explica um plano lento acima dele. A constatação aparece só quando o plano tem estatísticas de execução. Em planos do SQL Server, a estimativa é comparada em todas as execuções do operador; o PostgreSQL informa os dois números por loop.

Como corrigir isso. Comece com estatísticas: UPDATE STATISTICS no SQL Server, ANALYZE no PostgreSQL, ANALYZE TABLE no MySQL e MariaDB, DBMS_STATS.GATHER_TABLE_STATS no Oracle. Se os números ainda estiverem muito discrepantes, o predicado é difícil de estimar: colunas correlacionadas (do PostgreSQL) CREATE STATISTICS ajuda), uma função em uma coluna, ou uma variável local em T-SQL, cujo valor o otimizador não consegue ver (OPTION (RECOMPILE) permite).

Conversão implícita bloqueia uma busca

O que isso significa. O SQL Server precisava converter os valores de uma coluna para outro tipo antes de comparar, então não conseguiu fazer seek no índice dessa coluna e a varreu em vez disso. A causa clássica é um nvarchar parâmetro comparado com uma varchar coluna. O visualizador relata os avisos de conversão «Seek Plan» do SQL Server; conversões que afetam apenas estimativas de cardinalidade são listadas separadamente como avisos do otimizador.

Como corrigir isso. Faça o valor comparado ter o tipo da coluna: declare o parâmetro como varchar, defina explicitamente o tipo e o comprimento do parâmetro em seu código de acesso a dados, em vez de deixar que ele seja inferido a partir de uma string, ou altere a coluna se ela realmente deveria ser Unicode.

Busca por chave

O que isso significa. O SQL Server encontrou as linhas por um índice não clusterizado e depois voltou à tabela uma vez por linha para as colunas que o índice não contém (um Key Lookup, ou um RID Lookup em um heap). Barato para algumas linhas, caro para milhares, porque cada pesquisa é uma leitura separada.

Como corrigir isso. Se executar para muitas linhas, adicione as colunas ausentes à INCLUDE lista do índice para que ele cubra a consulta, ou selecione menos colunas. Para algumas linhas geralmente está bem - o plano marca como informação, não como aviso.

Transbordo para o tempdb

O que isso significa. Um operador de ordenação ou hash ficou sem a memória que o SQL Server concedeu à consulta e gravou linhas intermediárias no tempdb, o que é muito mais lento do que trabalhar na memória. Normalmente é sintoma de uma estimativa de linhas baixa: a concessão foi dimensionada para menos linhas do que realmente chegaram.

Como corrigir isso. Corrija a estimativa primeiro (veja desvio na estimativa de linhas), reduza as linhas que chegam ao operador com um filtro mais seletivo ou remova um desnecessário ORDER BY ou DISTINCT. Versões mais recentes do SQL Server ajustam as concessões de memória entre execuções por conta própria (memory grant feedback); o MIN_GRANT_PERCENT hint de consulta é a alavanca manual.

Colunas sem estatísticas

O que isso significa. O SQL Server não tinha estatísticas de uma coluna que a consulta filtra ou usa no join, então as estimativas de linhas dali são suposições.

Como corrigir isso. Certifique-se de que AUTO_CREATE_STATISTICS está ativado para o banco de dados, ou crie estatísticas nas colunas nomeadas com CREATE STATISTICS.

Sem predicado de junção

O que isso significa. Um join sem condição ligando as duas entradas, então cada linha de um lado se combina com cada linha do outro: duas tabelas de 1.000 linhas viram um milhão de linhas antes de qualquer filtro rodar. Quase sempre é uma cláusula ausente ou digitada errado ON cláusula.

Como corrigir isso. Adicione a condição de junção. Se você quer mesmo todas as combinações, escreva CROSS JOIN de forma que a intenção seja clara.

Meta de linhas

O que isso significa. TOP, EXISTS, IN ou OPTION (FAST n) disse ao SQL Server que ele só precisa das primeiras linhas, então escolheu um plano que começa a retornar resultados rapidamente - frequentemente loops aninhados sobre um índice - mesmo que custe mais para executar até o fim.

Como corrigir isso. Normalmente nada: esse é o plano que você quer para uma consulta top-N. Se a consulta acabar lendo muito mais linhas do que a meta presumia, a meta de linhas é a razão de o plano ter a forma que tem; o SQL Server 2016 SP1 e posteriores aceitam OPTION (USE HINT('DISABLE_OPTIMIZER_ROWGOAL')) para comparar com o plano sem ele.

Spool

O que isso significa. O SQL Server armazenou linhas intermediárias em uma tabela de trabalho (um Table Spool ou Index Spool) para reutilizá-las. Isso frequentemente é uma otimização sensata, mas um index spool ansioso significa que o otimizador está construindo um índice temporário a cada execução porque um permanente está ausente.

Como corrigir isso. Deixe como está, a menos que o spool responda por uma grande parte do custo. Para um spool de índice, crie o índice que ele está construindo - as colunas de busca mostram quais.

Outros avisos do otimizador

O que isso significa. Avisos registrados pelo mecanismo que não se encaixam em nenhuma categoria acima, mostrados com a própria redação do mecanismo - por exemplo, o aviso de concessão de memória excessiva do SQL Server (a consulta reservou muito mais memória do que usou, o que priva consultas concorrentes de memória) ou uma conversão de tipo que pode afetar as estimativas de cardinalidade.

Como corrigir isso. Leia os detalhes do operador. Concessões excessivas geralmente vêm de linhas superestimadas ou de varchar(max) colunas largas sendo ordenadas; as conversões são corrigidas da mesma forma que o aviso de conversão implícita.

Lendo a árvore e o diagrama

  • Os dados fluem para cima. O operador raiz - aquele que retorna linhas para você - está no topo. Seus filhos lhe fornecem linhas, então as folhas na parte inferior são onde os dados são lidos de tabelas e índices.
  • Compartilhamento de custo. A porcentagem é o custo estimado da subárvore do operador em relação à instrução inteira, o mesmo valor que SQL Server, PostgreSQL, MySQL e Oracle relatam. Os custos são unidades do otimizador, não milissegundos, e incluem tudo abaixo do operador; os planos do DuckDB usam tempo no lugar, e os do SQLite e do ClickHouse não têm custos.
  • Estimado → real. Em um plano real, cada operador mostra o que o otimizador esperava e o que realmente aconteceu. Um desvio de 10× ou mais é destacado, porque é aí que os planos erram.
  • Barras âmbar. No diagrama, a barra sob um operador indica sua participação no custo e fica âmbar quando esse operador tem um aviso.

O visualizador web e o aplicativo de desktop do SQLly

Esta página e o painel de plano no SQLly compartilham o mesmo parser e o mesmo motor de análise. O aplicativo de desktop adiciona tudo o que precisa de uma conexão ativa.

RecursoVisualizador webSQLly desktop
Achados, árvore de operadores e diagramaSimSim
Abrir ou colar um plano salvoSimSim
Capturar planos reais ou estimados com um atalho-Sim, direto do editor
Opções EXPLAIN (ANALYZE, BUFFERS, VERBOSE…) lembradas por conexão-Sim
Perfil predefinido que executa apenas instruções SELECT-Sim
Comparar duas capturas da mesma consulta-Sim
Abrir um índice sugerido em uma nova aba de consultaApenas copiarSim
Explicação guiada por IA do plano-Sim

FAQ do visualizador de plano de consulta

Este visualizador de plano de consulta é gratuito?

Sim. Não há necessidade de cadastro e não há limite para quantos planos você pode abrir. É o leitor de planos do aplicativo SQLly para desktop, publicado como uma ferramenta web gratuita.

Meu plano de execução é enviado para algum lugar?

Não. O visualizador é compilado para WebAssembly e roda dentro da aba do seu navegador. Um plano que você cola ou abre é lido no seu dispositivo; ele nunca é enviado para um servidor, registrado ou armazenado. Os planos contêm seu texto SQL, nomes de tabelas e, às vezes, valores de parâmetros, então isso é importante.

Quais formatos de plano ele pode ler?

SQL Server ShowPlan XML (.sqlplan arquivos, SET STATISTICS XML e SET SHOWPLAN_XML output), PostgreSQL EXPLAIN (FORMAT JSON) com ou sem ANALYZE, MySQL EXPLAIN FORMAT=JSON e EXPLAIN ANALYZE, MariaDB EXPLAIN FORMAT=JSON e ANALYZE FORMAT=JSON, SQLite EXPLAIN QUERY PLAN, DuckDB EXPLAIN (FORMAT JSON), ClickHouse EXPLAIN json = 1 e Oracle DBMS_XPLAN saída. O formato é detectado automaticamente.

Capturar um plano real executa minha consulta?

Sim. SET STATISTICS XML, EXPLAIN ANALYZE, ANALYZE FORMAT=JSON e GATHER_PLAN_STATISTICS todos executam a instrução, incluindo qualquer INSERT, UPDATE ou DELETE. Use a forma estimada (SET SHOWPLAN_XML, EXPLAIN sem ANALYZE, EXPLAIN PLAN FOR) quando a instrução não deve rodar, ou envolva uma alteração de dados em uma transação que você reverte.

Por que não consegue ler meu plano PostgreSQL?

O visualizador lê o formato de plano JSON do PostgreSQL, não o formato de texto padrão. Execute EXPLAIN (FORMAT JSON) ou EXPLAIN (ANALYZE, FORMAT JSON) e cole o resultado. Saída copiada diretamente do psql, incluindo seu QUERY PLAN cabeçalho e o + no final de cada linha, é limpo automaticamente.

Por que os custos ou contagens de linhas estão ausentes para alguns mecanismos?

O visualizador mostra apenas o que o mecanismo relata. No SQLite, o EXPLAIN QUERY PLAN não tem custos ou estimativas de linhas, ClickHouse não tem modelo de custo, e DuckDB não tem unidades de custo, então esses planos mostram a estrutura do operador e as varreduras em vez das partes de custo. As contagens reais de linhas aparecem apenas para planos capturados com estatísticas de tempo de execução.

Posso comparar dois planos de execução?

Não no visualizador web. O aplicativo desktop SQLly mantém um histórico dos planos que você captura em cada aba de consulta e compara quaisquer dois deles, destacando operadores que regrediram, melhoraram, apareceram ou desapareceram.

// sem copiar e colar

Capture, leia e compare planos onde você escreve SQL

O SQLly é um ambiente de trabalho SQL nativo para macOS, Windows e Linux. Pressione Explain no editor para capturar um plano real ou estimado, ler as mesmas análises desta página e comparar duas execuções para provar que um ajuste funcionou.