Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
Quando uma consulta está lenta, o seu primeiro passo é o EXPLAIN. Ele mostra exatamente como o MySQL planeja executar a consulta — quais índices ele usa, quantas linhas espera varrer e onde está fazendo trabalho caro. Depois que você sabe lê-lo, consegue corrigir quase qualquer consulta lenta.

Executando o EXPLAIN

Coloque EXPLAIN na frente de qualquer SELECT:
O MySQL retorna uma linha por tabela na consulta. Para joins, você recebe várias linhas — uma por tabela envolvida.

As Colunas Que Importam

Uma linha completa do EXPLAIN se parece com isto:
A maioria das colunas importa em alguns momentos. Estas importam quase sempre:

type — Como o MySQL varre a tabela

Esta é a coluna mais importante. Ela informa o método de acesso, do mais rápido ao mais lento: ALL é o que precisa ser corrigido. Significa que o MySQL está lendo todas as linhas da tabela. Em uma tabela com um milhão de linhas, isso é um milhão de leituras a cada execução da consulta.

key — Qual índice o MySQL escolheu

NULL significa que nenhum índice foi usado. Se possible_keys lista índices, mas key é NULL, o MySQL decidiu que uma varredura completa era mais barata — geralmente porque a tabela é pequena ou a consulta não é seletiva o suficiente.

rows — Estimativa de linhas examinadas

Uma estimativa, não uma garantia. O MySQL usa estatísticas para produzir esse número. Uma consulta com rows: 1 é rápida; rows: 5000000 em uma tabela de produção é um problema.

Extra — Detalhes adicionais de execução

A coluna Extra contém flags importantes: Using filesort e Using temporary juntos em tabelas grandes são sinais de alerta.

Um Exemplo Completo

Dois problemas: varredura completa da tabela (ALL) e um filesort. Corrija os dois com um índice composto (consulte Como os Índices do MySQL Funcionam para os princípios de projeto de índices):
rows caiu de 1.000.000 para 4.200. type agora é ref — uma busca por igualdade em status. O filesort sumiu porque o índice já ordena as linhas por created_at dentro de cada valor de status.

EXPLAIN ANALYZE

EXPLAIN ANALYZE de fato executa a consulta e retorna os tempos reais ao lado das estimativas:
cost e rows são as estimativas do otimizador. actual time e actual rows são o que realmente aconteceu. Uma diferença grande entre as linhas estimadas e as reais indica estatísticas desatualizadas — execute ANALYZE TABLE orders para atualizá-las.

Perguntas Frequentes

Qual é a relação entre o EXPLAIN e os índices de cobertura?

Extra: Using index significa que o MySQL está usando um índice de cobertura — ele consegue responder à consulta inteiramente a partir do índice, sem ler as linhas da tabela. Essa é uma das otimizações de maior impacto disponíveis em tabelas com muitas leituras. Consulte Índices de Cobertura no MySQL para saber como projetá-los.

Minha consulta tem type: index — isso é aceitável?

Não muito. type: index significa que o MySQL varreu o índice inteiro (em vez da tabela), o que é mais rápido que ALL, mas ainda é uma varredura completa. Ele aparece quando uma consulta precisa de todas as linhas, mas consegue satisfazê-la a partir do índice. Se você está vendo isso em tabelas grandes, verifique se um índice de cobertura ou uma cláusula WHERE poderia estreitar a varredura.

Por que o MySQL ignora o índice que criei?

O otimizador escolhe os índices com base em estatísticas. Se a tabela é pequena, o MySQL pode decidir que uma varredura completa é mais barata. Se as estatísticas estão desatualizadas, ele pode subestimar quão seletivo é o seu índice. Execute ANALYZE TABLE para atualizar as estatísticas e depois verifique o EXPLAIN de novo.

Posso usar o EXPLAIN em INSERT, UPDATE e DELETE?

Sim — o EXPLAIN funciona em todas as instruções DML no MySQL 8.0+. A saída mostra o método de acesso para as linhas que estão sendo modificadas, o que é útil quando um UPDATE ou DELETE está lento. Se você precisa identificar quais consultas examinar com o EXPLAIN primeiro, o Log de Consultas Lentas do MySQL captura as consultas mais lentas no seu servidor e as classifica por tempo total.

Solução de Problemas

Veja também