Curso de MariaDB / Programar tareas con Event Scheduler y comprobar resultados
El programador de eventos de MariaDB ejecuta SQL a una hora o con un intervalo definidos. Que exista un evento, que el programador esté activo y que la tarea haya producido su resultado son condiciones diferentes: compruebe los metadatos y los datos generados.
Elegir una tarea y una cuenta de ejecución adecuadas
Un evento puede mantener un resumen breve o realizar una limpieza acotada dentro de la base. Las API externas, los archivos o los reintentos y alertas coordinados entre sistemas pueden necesitar un proceso de aplicación o un planificador operativo. Este ejemplo inserta un registro de ejecución en lugar de borrar datos, de modo que el resultado sea fácil de observar.
Utilice appops_lab y una cuenta de prácticas con CREATE TABLE, INSERT y EVENT. El evento actúa con los permisos de su cuenta DEFINER, no mediante la conexión actual del cliente. Cambiar esa cuenta o sus permisos puede afectar a ejecuciones posteriores. La introducción oficial a los eventos explica el servicio y sus objetos.
Revisar el estado y las zonas horarias
SELECT @@GLOBAL.event_scheduler, @@GLOBAL.time_zone, @@SESSION.time_zone;
El programador debe estar ON para ejecutar los horarios. Con OFF pueden existir definiciones sin ejecutarse. DISABLED requiere revisar la configuración de arranque y la política administrativa, en lugar de suponer que un cambio ordinario a ON funcionará. Habilitarlo globalmente en un servidor compartido puede activar también otros eventos.
Solo en un servidor nuevo dedicado a prácticas, su administrador puede habilitarlo si es necesario con SET GLOBAL event_scheduler = ON;. Registre el valor original. Al terminar, detenga primero su evento; volver a desactivar globalmente el servicio exige considerar las demás tareas.
El script utiliza la zona de sesión +00:00 para definir expresamente cómo se interpreta la programación. Guarde la anterior y restáurela al final. El reloj y la zona de presentación del equipo cliente no son necesariamente el contexto del servidor.
Crear una tabla de resultados y una definición deshabilitada
Compruebe antes el servidor, la base y los objetos existentes. Si appops_lab contiene otras prácticas, consérvelas; confirme que event_runs y record_run no están en uso antes de crearlos.
CREATE DATABASE IF NOT EXISTS appops_lab
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE appops_lab;
CREATE TABLE event_runs (
run_id BIGINT NOT NULL AUTO_INCREMENT PRIMARY KEY,
ran_at DATETIME(6) NOT NULL,
run_label VARCHAR(40) NOT NULL
) ENGINE=InnoDB;
SET @event_saved_time_zone = @@SESSION.time_zone;
SET SESSION time_zone = '+00:00';
CREATE EVENT appops_lab.record_run
ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 10 SECOND
ON COMPLETION PRESERVE
DISABLE
DO INSERT INTO appops_lab.event_runs (ran_at, run_label) VALUES (UTC_TIMESTAMP(6), 'scheduled-check');
DISABLE evita ejecutar la tarea antes de revisarla. ON COMPLETION PRESERVE conserva la definición de un evento de una sola ejecución cuando termina su horario. No es una política de conservación de datos ni una garantía de reintentos. La referencia oficial de CREATE EVENT explica horarios y finalización.
SELECT @@GLOBAL.event_scheduler;
SELECT EVENT_NAME, STATUS, TIME_ZONE, EXECUTE_AT, LAST_EXECUTED
FROM information_schema.EVENTS
WHERE EVENT_SCHEMA = 'appops_lab' AND EVENT_NAME = 'record_run';
SELECT run_id, ran_at, run_label FROM appops_lab.event_runs ORDER BY run_id;
Al principio debe existir un evento con STATUS DISABLED y la tabla de resultados debe estar vacía. Puede inspeccionar la definición aunque el programador esté apagado. Revise nombre, base y zona horaria antes de habilitarlo.
Fijar una hora futura nueva y comprobar la fila real
Los diez segundos del CREATE pueden haber pasado mientras leía o conectaba. Programe de nuevo una hora futura al habilitarlo para no reutilizar un instante ya vencido.
ALTER EVENT appops_lab.record_run
ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 10 SECOND
ENABLE;
Al cabo de unos diez segundos, repita el bloque de inspección. No es un temporizador de tiempo real exacto; la coincidencia milimétrica con el reloj no es un criterio de éxito. Debe aparecer una fila con scheduled-check, que significa comprobación programada, y LAST_EXECUTED debe tener un valor. El evento de una sola ejecución conservado queda DISABLED tras completarse.
LAST_EXECUTED indica un intento de ejecución; por sí solo no demuestra que toda una tarea de negocio terminara correctamente. Concilie también la fila real. Cada ejecución utiliza otra conexión, por lo que el contador de filas afectadas del cliente actual tampoco demuestra que se ejecutara el evento.
Acotar una programación periódica y definir los reintentos
Después de observar la ejecución única, la programación acotada siguiente permite probar la repetición. El final explícito evita dejar una tarea de prácticas ilimitada:
ALTER EVENT appops_lab.record_run
ON SCHEDULE EVERY 1 MINUTE
STARTS CURRENT_TIMESTAMP + INTERVAL 1 MINUTE
ENDS CURRENT_TIMESTAMP + INTERVAL 3 MINUTE
ENABLE;
El cuerpo del ejemplo añade una fila por ejecución. Un resumen real necesita una clave única para su período y una política de repetición. Recalcular desde las fuentes o hacer la operación idempotente —que repetirla no duplique su efecto— evita sumar dos veces por un reintento. Revise también el solapamiento si una ejecución puede durar más que el intervalo.
Las limitaciones oficiales de los eventos explican horarios, orden y conexiones de ejecución separadas. En replicación o cambio de servidor, defina quién es responsable de la tarea para evitar ejecutarla en varios servidores involuntariamente.
Detener, diagnosticar y retirar las prácticas
ALTER EVENT appops_lab.record_run DISABLE;
SHOW CREATE EVENT appops_lab.record_run;
- Deshabilite futuras ejecuciones y compruebe que terminó el trabajo. Deshabilitar el horario no cancela necesariamente una invocación que ya está ejecutándose.
- Revise el estado del programador, STATUS, los permisos del DEFINER, TIME_ZONE y las fechas. Si cambia LAST_EXECUTED sin el resultado esperado, inspeccione el registro de errores y las condiciones del SQL.
- Cuando ya no necesite los resultados, elimine primero el evento y después su tabla prescindible.
DROP EVENT appops_lab.record_run;
DROP TABLE appops_lab.event_runs;
SET SESSION time_zone = @event_saved_time_zone;
Restaure también la zona horaria original de la sesión. DROP EVENT y DROP TABLE no se revierten con un ROLLBACK ordinario; confirme los nombres y conserve otras prácticas de appops_lab. Si una tarea periódica falla, determine su causa y qué trabajo debe repetirse antes de editar una definición activa: de otro modo es difícil distinguir omisiones de duplicaciones.




