Curso de MariaDB / Leer EXPLAIN y comparar planes antes y después de un índice

EXPLAIN muestra el plan de ejecución elegido por el optimizador de MariaDB. Compare la misma consulta y sus resultados antes y después de añadir un índice, y distinga los métodos de acceso, las claves elegidas y las filas estimadas de las mediciones de ejecución real.

Leer los campos del plan dentro de su contexto

Empiece por identificar las tablas consultadas y las claves que pueden acotar sus filas. Un acceso ALL no es automáticamente incorrecto, y Using filesort no demuestra por sí solo que la ordenación se haya escrito en un archivo de disco. Considere el tamaño, la proporción de filas seleccionadas y la latencia observada. La guía de índices simples y compuestos explica cómo justificar una clave candidata.

Campo Cómo interpretarlo Qué evitar
table Tabla o alias de esta etapa Suponer que toda consulta tiene una sola etapa
type Método de acceso Descartar siempre un recorrido de una tabla pequeña
possible_keys / key Claves candidatas / clave elegida Suponer que un índice existente debe elegirse
rows Filas estimadas para el acceso Tomarlo como recuento exacto de filas devueltas
Extra Detalles de filtrado, ordenación y cobertura Juzgar todo el plan por una sola frase

La referencia oficial de EXPLAIN describe estos campos y los métodos de acceso.

Generar un juego de 1.000 filas reproducible

Conéctese como course_user a shopcourse y compruebe SELECT VERSION(), DATABASE();. La guía del cliente y los archivos SQL detalla la conexión y la ejecución de un archivo UTF-8 con SOURCE. Revise que digits_40_lab y explain_40_lab no existan; si existen, inspeccione sus datos y definiciones antes de decidir si son objetos prescindibles de prácticas.

El bloque completo combina tres dígitos decimales para generar 1.000 filas sin leer ni modificar pedidos de una aplicación. Los ID de cliente van de 1 a 100 y cada cliente tiene diez 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;

Compruebe que SELECT COUNT(*) FROM explain_40_lab; devuelve 1000. La distribución artificial sirve para aprender a interpretar el plan; no representa el volumen, la distribución desigual ni la carga de un sistema de producción.

Comparar el mismo EXPLAIN antes y después del índice

Guarde primero el plan de esta consulta, sin añadir todavía la clave secundaria:

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;

Añada después el índice y vuelva a obtener el plan de la misma 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;

El primer plan no dispone de una clave secundaria por cliente y fecha; el segundo tiene una nueva candidata. Revise la clave elegida y las filas estimadas en su salida. Las estadísticas, la versión y la distribución de datos pueden cambiar los detalles; no memorice un número del plan como resultado universal.

En una ejecución de este juego de 1.000 filas sobre una instancia privada de MariaDB 12.3.3 se observaron los valores siguientes. Se comparó la misma consulta antes y después de crear el índice; los valores de otro entorno pueden diferir.

Etapa type key rows Extra
Antes del índice ALL NULL 1000 Using where; Using filesort
Después del índice range idx_e40_customer_date 10 Using where; Using index

En esa observación, el recorrido completo pasó a un acceso por intervalo y la estimación bajó de 1000 a 10. Eso no es una medición de una ejecución cien veces más rápida. Compruebe por separado los diez pedidos devueltos y los datos de ejecución.

Comprobar el resultado independientemente 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;

Se devuelven diez identificadores: 47, 147, 247, 347, 447, 547, 647, 747, 847 y 947, con sus fechas y horas. El mismo SELECT debe producir las mismas filas, en el mismo orden, con el índice y sin él. El campo rows de EXPLAIN estima el trabajo de acceso de una etapa, no el número final de registros mostrados.

Un plan no garantiza una latencia. Una comparación temporal útil controla consulta, datos, carga concurrente y condiciones de caché y repite las observaciones. No extrapole un pequeño cambio de tiempo sintético a un porcentaje de mejora de todo un servicio.

Distinguir ANALYZE de la actualización de estadísticas

Las sentencias ANALYZE de MariaDB ejecutan la consulta para recoger información real. No las considere equivalentes a anteponer EXPLAIN sin ejecutar un UPDATE o DELETE. Si necesita analizar una modificación, revise su alcance y permisos y use un entorno separado apropiado.

ANALYZE TABLE es otra operación: actualiza las estadísticas de la tabla. Las estadísticas desactualizadas pueden distorsionar las estimaciones, pero renovarlas también tiene costes y consideraciones de bloqueo según la versión. Investigue la consulta y los datos antes de intentar imponer un plan mediante FORCE INDEX.

Para obtener datos reales de este ejercicio, aplique el bloque siguiente únicamente al SELECT de prácticas. ANALYZE FORMAT=JSON ejecuta esa consulta. Distinga r_rows, el promedio de filas leídas en el nodo, y r_loops, sus ejecuciones, de la estimación rows. Los tiempos dependen del entorno y no tienen un valor esperado fijo.

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;

La referencia oficial de ANALYZE FORMAT=JSON documenta sus campos medidos. Esta consulta SELECT de análisis no modifica las filas del ejercicio; no generalice esa propiedad a cualquier sentencia que ANALYZE pueda ejecutar.

Guardar evidencia reproducible y retirar solo las prácticas

Conserve la versión del servidor, las definiciones e índices, el método de generación de datos, la consulta y los planes anterior y posterior. Registre también los resultados para que una diferencia de acceso no oculte un cambio de significado.

Compruebe las necesidades de conservación antes de eliminar las dos tablas siguientes. No tienen una relación de clave foránea y ninguna tabla de pedidos de una aplicación forma parte de esta limpieza. DROP TABLE elimina estructuras y datos y no se revierte con un ROLLBACK ordinario.

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