Curso de MariaDB / Ler EXPLAIN e comparar planos antes e depois de um índice

EXPLAIN mostra o plano de execução escolhido pelo otimizador do MariaDB. Compare a mesma consulta e seus resultados antes e depois de acrescentar um índice e diferencie métodos de acesso, chaves escolhidas e linhas estimadas das medições de execução real.

Ler os campos do plano no contexto

Comece pelas tabelas consultadas e pelas chaves que podem delimitar suas linhas. Um acesso ALL não é automaticamente incorreto, e Using filesort não comprova sozinho que a ordenação foi gravada em um arquivo no disco. Considere tamanho, proporção de linhas selecionadas e latência observada. O guia de índices simples e compostos explica como justificar uma chave candidata.

Campo Como interpretar O que evitar
table Tabela ou alias desta etapa Supor uma única etapa em toda consulta
type Método de acesso Rejeitar sempre a varredura de tabela pequena
possible_keys / key Chaves candidatas / escolhida Supor que um índice existente precisa ser escolhido
rows Linhas estimadas para o acesso Interpretar como contagem exata de linhas retornadas
Extra Detalhes de filtro, ordenação e cobertura Julgar todo o plano por uma frase

A referência oficial de EXPLAIN descreve os campos e métodos de acesso.

Gerar um conjunto reproduzível de 1.000 linhas

Conecte como course_user a shopcourse e confira SELECT VERSION(), DATABASE();. O guia do cliente e dos arquivos SQL detalha conexão e execução de arquivo UTF-8 com SOURCE. Confira se digits_40_lab e explain_40_lab não existem; se existirem, examine dados e definições antes de decidir se são objetos prescindíveis de prática.

O bloco completo combina três dígitos decimais para gerar 1.000 linhas sem consultar ou modificar pedidos de uma aplicação. Os IDs de cliente vão de 1 a 100 e cada cliente tem dez pedidos.

USE shopcourse;
CREATE TABLE digits_40_lab(n TINYINT PRIMARY KEY) ENGINE=InnoDB;
INSERT INTO digits_40_lab VALUES(0),(1),(2),(3),(4),(5),(6),(7),(8),(9);
CREATE TABLE explain_40_lab(
 order_id INT PRIMARY KEY,customer_id INT NOT NULL,
 ordered_at DATETIME NOT NULL,amount DECIMAL(10,2) NOT NULL
) ENGINE=InnoDB;
INSERT INTO explain_40_lab
SELECT 1+a.n+10*b.n+100*d.n,
 MOD(a.n+10*b.n+100*d.n,100)+1,
 DATE_ADD('2026-01-01',INTERVAL (a.n+10*b.n+100*d.n) MINUTE),1000
FROM digits_40_lab a CROSS JOIN digits_40_lab b CROSS JOIN digits_40_lab d;

Confira se SELECT COUNT(*) FROM explain_40_lab; retorna 1000. A distribuição artificial ensina a interpretar o plano; não representa volume, distribuição desigual ou carga de um sistema de produção.

Comparar o mesmo EXPLAIN antes e depois do índice

Guarde primeiro o plano desta consulta, antes de acrescentar a chave secundária:

EXPLAIN SELECT order_id,ordered_at FROM explain_40_lab
WHERE customer_id=47 AND ordered_at>='2026-01-01'
ORDER BY ordered_at,order_id;

Acrescente depois o índice e obtenha novamente o plano da mesma consulta:

CREATE INDEX idx_e40_customer_date
ON explain_40_lab(customer_id,ordered_at,order_id);
EXPLAIN SELECT order_id,ordered_at FROM explain_40_lab
WHERE customer_id=47 AND ordered_at>='2026-01-01'
ORDER BY ordered_at,order_id;

O primeiro plano não dispõe de chave secundária por cliente e data; o segundo tem uma candidata nova. Confira a chave escolhida e as linhas estimadas na sua saída. Estatísticas, versão e distribuição dos dados podem mudar os detalhes; os números de um plano não são resultados universais.

Em uma execução deste conjunto de 1.000 linhas em uma instância privada do MariaDB 12.3.3, os valores seguintes foram observados. A mesma consulta foi comparada antes e depois da criação do índice; outros ambientes podem apresentar valores diferentes.

Etapa type key rows Extra
Antes do índice ALL NULL 1000 Using where; Using filesort
Depois do índice range idx_e40_customer_date 10 Using where; Using index

Nessa observação, a varredura completa passou para acesso por intervalo e a estimativa caiu de 1000 para 10. Isso não mede uma execução cem vezes mais rápida. Confira separadamente os dez pedidos retornados e os dados de execução.

Conferir o resultado independentemente de rows

SELECT order_id,ordered_at FROM explain_40_lab
WHERE customer_id=47 AND ordered_at>='2026-01-01'
ORDER BY ordered_at,order_id;

São retornados dez identificadores: 47, 147, 247, 347, 447, 547, 647, 747, 847 e 947, com suas datas e horas. O mesmo SELECT precisa produzir as mesmas linhas, na mesma ordem, com o índice e sem ele. O campo rows de EXPLAIN estima o trabalho de acesso de uma etapa, não a quantidade final de registros mostrados.

Um plano não garante uma latência. Uma comparação de tempo útil controla consulta, dados, carga concorrente e condições de cache e repete as observações. Uma pequena diferença sintética de tempo não comprova uma porcentagem de melhoria de todo um serviço.

Distinguir ANALYZE da atualização de estatísticas

As instruções ANALYZE do MariaDB executam a consulta para obter informações reais. Diferencie-as de acrescentar EXPLAIN sem executar UPDATE ou DELETE. Para analisar uma alteração, examine alcance e permissões e use um ambiente separado adequado.

ANALYZE TABLE é outra operação: atualiza estatísticas da tabela. Estatísticas desatualizadas podem distorcer estimativas, mas renová-las também tem custos e considerações de bloqueio conforme a versão. Investigue consulta e dados antes de tentar impor um plano com FORCE INDEX.

Para obter dados reais deste exercício, aplique o bloco seguinte somente ao SELECT de prática. ANALYZE FORMAT=JSON executa essa consulta. Diferencie r_rows, média de linhas lidas no nó, e r_loops, quantidade de execuções, da estimativa rows. Os tempos dependem do ambiente e não têm valor esperado fixo.

ANALYZE FORMAT=JSON
SELECT order_id,ordered_at FROM explain_40_lab
WHERE customer_id=47 AND ordered_at>='2026-01-01'
ORDER BY ordered_at,order_id;

A referência oficial de ANALYZE FORMAT=JSON documenta os campos medidos. Este SELECT de análise preserva as linhas da prática; isso não se aplica automaticamente a qualquer instrução que ANALYZE possa executar.

Guardar evidências reproduzíveis e remover somente a prática

Conserve versão do servidor, definições e índices, método de geração dos dados, consulta e planos anterior e posterior. Registre também os resultados para que uma mudança de acesso não esconda uma mudança de significado.

Confira o que precisa conservar antes de remover as duas tabelas seguintes. Elas não têm relação de chave estrangeira, e nenhuma tabela de pedidos de uma aplicação faz parte desta limpeza. DROP TABLE remove estrutura e dados e não é desfeito por um ROLLBACK comum.

DROP TABLE shopcourse.explain_40_lab;
DROP TABLE shopcourse.digits_40_lab;