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;




