EXPLAIN e queries lentas

Plano visual

O botão Plano de query visual na barra do editor desenha o plano da query atual como uma árvore, no PostgreSQL, MySQL e SQL Server.

• Cada nó mostra a operação, a tabela ou o índice usado, as linhas estimadas e o custo.
• Uma barra mostra a fatia de custo de cada nó, de verde a vermelho.
• O nó mais caro ganha a marca de gargalo.

Os tipos de acesso do MySQL ganham nomes legíveis (Full Table Scan, Index Lookup). O plano é a estimativa do planner; a query não roda. Também dá para abrir a partir de uma query no Trace.

Plano em texto

Explicar na barra mostra o plano do próprio banco em texto, para o primeiro comando da seleção ou da aba: EXPLAIN no PostgreSQL, MySQL, ClickHouse e Trino, e EXPLAIN QUERY PLAN no SQLite. No SQL Server, use o plano visual.

Todo plano em texto vai para o Histórico de query plans (o ícone de relógio), para você comparar um plano antes e depois de uma mudança. Veja Histórico e biblioteca.

IA › Explicar esta query é outra coisa: uma explicação em português do que a query faz.

Acelerar esta query

No PostgreSQL, MySQL e SQL Server, com a IA configurada, IA › Acelerar esta query… propõe um índice para uma leitura lenta e testa. Depois que uma query leva cinco segundos ou mais, um botão Acelerar também aparece embaixo do editor.

1. O Lily tira todos os valores da query e manda ela, o plano e o schema para a sua ferramenta de IA.
2. A IA propõe um CREATE INDEX em colunas simples. Qualquer outra coisa (vários comandos, índices de expressão) é recusada.
3. Aplicar e provar mede o custo da sua query segundo o planner, cria o índice (CONCURRENTLY no PostgreSQL, para as escritas seguirem) e mede de novo.

O resultado mostra o custo antes e depois. É a estimativa do planner, não um tempo medido; a velocidade de verdade depende dos seus dados e do cache.

Se a estimativa não caiu, o índice fica. Remova você mesmo se não quiser. (O Investigar desfaz as correções que não ajudaram.)

Numa conexão somente leitura o botão vira Copiar índice.

Sugerir índices

IA › Sugerir índices… revisa suas leituras recentes na conexão e recomenda índices em texto. Nada é criado. Veja IA no editor.