Planos de consulta

em andamento

Transforme um plano de execução em descobertas úteis, uma árvore navegável ou um diagrama que você possa seguir.

Um plano de consulta é o banco de dados explicando como pretende responder à sua consulta: quais índices ele usa, como ele faz junções e para onde vai o custo. O SQLly transforma essa explicação em linguagem simples achados, um operador árvore, e um diagrama. Um modelo único deixa um plano do PostgreSQL, um plano do SQL Server e um plano do ClickHouse ou Oracle legíveis da mesma forma.

Capturando um plano

CapturarO que fazExecuta a consulta?
Real (⌘L / o botão Explicar)Executa a consulta e captura o plano com real contagem de linhas.Sim
Estimado (menu / paleta de comandos)Pede ao mecanismo o plano dele sem executar - apenas estimativas.Não
PerfilUma captura real com detalhes extras (buffers, verbose). Somente SELECT.Sim
Abrir / ColarCarregar um plano salvo .sqlplan/.json/.xml ou um da área de transferência - nada é executado.Não
Real vs estimado. Um plano real foi executado, então as contagens de linhas dele mostram o que aconteceu e podem revelar onde as estimativas erraram. Um plano estimado evita a execução, o que o torna o ponto de partida mais seguro para uma instrução pesada ou destrutiva. O SQLly avisa sempre que uma captura vai executar a consulta.

Achados - o plano em linguagem humana

A visão padrão não é uma parede de operadores - é uma lista classificada de achados, do pior para o melhor. Cada um é escrito em linguagem simples com um resumo, um por que, e uma sugestão de ação sugerida, muitas vezes com SQL pronto para executar, que você pode copiar ou abrir em uma nova aba, mais o detalhe técnico a um clique de distância.

  • Varredura de tabela - «Varre cada linha de dbo.Orders para encontrar correspondências.»
  • Índice ausente - com um CREATE NONCLUSTERED INDEX instrução.
  • Divergência entre estimativa e valor real - «Estimou 10 linhas mas leu 48.2K → atualize as estatísticas» (apenas em planos reais).
  • Conversão implícita, busca por chave, despejo para o tempdb, estatísticas ausentes, produto cartesiano (sem predicado de junção), objetivos de linha e spools - cada um com sua própria explicação e correção.

Abaixo das descobertas, um Operadores lista mostra cada operador do mais caro para o menos caro - “Index Seek — 4 linhas estimadas, 91% do custo, leitura 7” - com detalhes completos por operador (ID do nó, operador físico/lógico, custo de CPU/E/S, linhas reais, avisos, colunas de saída) ao expandir.

Árvore e diagrama

Árvore é a hierarquia de operadores como uma árvore com recuo, recolhível, cada linha mostrando o operador, sua fatia do custo, linhas estimadas, o → actual contagem (em destaque quando diverge), e um ⚠ total de avisos, com navegação pelo teclado.

Diagrama desenha o plano de cima para baixo como uma tela de nós e arestas. Cada nó é uma caixa com o nome do operador, um cost% · estimated rows → actual linha, e um barra de custo cujo comprimento acompanha a fatia de custo do operador e fica âmbar quando carrega um aviso. As arestas são desenhadas de pai para filho com pontas de seta; você pode arrastar a tela e clicar em qualquer nó para selecioná-lo e ver os detalhes completos dele abaixo — a mesma seleção que a árvore compartilha.

SQLly
Diagrama gráfico de plano de consulta do SQLlyDiagrama gráfico de plano de consulta do SQLly
O diagrama do plano gráfico: nós de operadores com barras de custo conectados por arestas com setas, com os detalhes do nó selecionado abaixo.

Lotes, planos limpos e comparação

  • Lotes de múltiplas instruções ganham uma faixa de abas por instrução - os achados ficam agrupados por instrução em vez de misturados.
  • Planos limpos dizem isso claramente: “Este plano parece bom. Nenhum problema detectado.” A lista de Operadores continua lá para quando você quiser.
  • Modo de comparação mantém capturas recentes e compara uma linha de base com uma execução posterior - destacando os operadores que regrediram, melhoraramou foram adicionados/removidos, para que você possa provar que uma mudança de tuning realmente ajudou.
  • Uma Explicação por IA a ação fornece ao assistente um resumo limitado do plano para uma explicação em linguagem natural.

Suporte a mecanismos

MotorRealEstimado
SQL ServerSET STATISTICS XMLSET SHOWPLAN_XML
PostgreSQLEXPLAIN (ANALYZE, FORMAT JSON)EXPLAIN (FORMAT JSON)
MySQL 8EXPLAIN ANALYZEEXPLAIN FORMAT=JSON
MariaDBANALYZE FORMAT=JSONEXPLAIN FORMAT=JSON
SQLiteEXPLAIN QUERY PLAN (somente estimado - nunca executa)
libSQL / TursoEXPLAIN QUERY PLAN (somente estimado - plano do SQLite pela rede)
DuckDBEXPLAIN ANALYZEEXPLAIN
ClickHouse- (sem EXPLAIN ANALYZE)EXPLAIN json = 1, com as partes e os grânulos que cada índice aparou
OracleSTATISTICS_LEVEL = ALL, lido de volta de V$SQL_PLAN_STATISTICS_ALLEXPLAIN PLAN FOR lido de volta de PLAN_TABLE

Cada dialeto é analisado no mesmo modelo de plano, então as descobertas - varreduras de tabela, compartilhamento de custo, estimativa vs. real, leitura consistente não importa qual mecanismo produziu o plano. Onde um mecanismo tem apenas uma forma estimada, o comando Real indica isso e aponta para Estimado; no ClickHouse também aponta para Insights de consulta para linhas, bytes e memória de uma execução. Comandos Redis não têm plano de execução algum - SLOWLOG GET mostra seus tempos.