Planos de consulta
em andamentoTransforme 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
| Capturar | O que faz | Executa 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 |
| Perfil | Uma captura real com detalhes extras (buffers, verbose). Somente SELECT. | Sim |
| Abrir / Colar | Carregar um plano salvo .sqlplan/.json/.xml ou um da área de transferência - nada é executado. | Não |
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 INDEXinstruçã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.


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
| Motor | Real | Estimado |
|---|---|---|
| SQL Server | SET STATISTICS XML | SET SHOWPLAN_XML |
| PostgreSQL | EXPLAIN (ANALYZE, FORMAT JSON) | EXPLAIN (FORMAT JSON) |
| MySQL 8 | EXPLAIN ANALYZE | EXPLAIN FORMAT=JSON |
| MariaDB | ANALYZE FORMAT=JSON | EXPLAIN FORMAT=JSON |
| SQLite | EXPLAIN QUERY PLAN (somente estimado - nunca executa) | |
| libSQL / Turso | EXPLAIN QUERY PLAN (somente estimado - plano do SQLite pela rede) | |
| DuckDB | EXPLAIN ANALYZE | EXPLAIN |
| ClickHouse | - (sem EXPLAIN ANALYZE) | EXPLAIN json = 1, com as partes e os grânulos que cada índice aparou |
| Oracle | STATISTICS_LEVEL = ALL, lido de volta de V$SQL_PLAN_STATISTICS_ALL | EXPLAIN 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.