Cours MariaDB / Planifier un événement et vérifier son exécution réelle

Le planificateur d’événements MariaDB exécute du SQL à une date ou à un intervalle défini. L’existence de la définition, l’activation du planificateur et la réussite du travail sont trois conditions différentes : vérifiez les métadonnées de planification et les données effectivement produites.

Choisir une tâche et son compte d’exécution

Un événement peut entretenir un petit récapitulatif dans la base ou effectuer un nettoyage limité. Des appels à des API externes, des transferts de fichiers ou des reprises et alertes coordonnées entre plusieurs systèmes relèvent souvent mieux d’un programme de traitement ou d’un ordonnanceur d’exploitation. Cet exercice ajoute une ligne de résultat plutôt que de supprimer des données, afin de rendre l’exécution observable.

Utilisez uniquement le schéma d’apprentissage appops_lab, avec les droits CREATE TABLE, INSERT et EVENT nécessaires. L’événement s’exécute avec les droits de son compte DEFINER, et non pour le compte du client qui est actuellement connecté. Un changement de compte ou de droits peut donc affecter les prochaines exécutions. Le guide des comptes et des autorisations aide à délimiter ce périmètre ; la présentation officielle des événements MariaDB décrit leur fonctionnement.

Examiner le planificateur et les fuseaux horaires

Dans le client MariaDB, relevez d’abord l’état global et les fuseaux horaires :

SELECT @@GLOBAL.event_scheduler, @@GLOBAL.time_zone, @@SESSION.time_zone;

Le planificateur doit être ON pour exécuter les tâches. Avec OFF, les définitions peuvent exister sans être exécutées. L’état DISABLED impose de vérifier la configuration de démarrage et la politique de l’administrateur ; une simple activation à chaud ne suffit pas nécessairement. Sur un serveur partagé, activer le planificateur global peut aussi lancer d’autres événements.

Uniquement sur un nouveau serveur réservé à cet exercice, l’administrateur peut l’activer si nécessaire avec SET GLOBAL event_scheduler = ON;. Notez sa valeur initiale. À la fin, arrêtez d’abord votre propre événement ; remettre le planificateur global sur OFF nécessite d’avoir vérifié l’effet sur les autres tâches.

Le script de création utilise le fuseau de session +00:00 afin de rendre explicite l’interprétation des dates de planification. Il conserve la valeur précédente pour la restaurer ensuite. L’heure affichée sur le PC client ne correspond pas forcément au contexte horaire utilisé par le serveur. Gardez la même connexion pour conserver la variable de session de cet exercice.

Créer la table de résultat et un événement désactivé

Avec un compte autorisé, créez les objets dans appops_lab. Si le schéma existe déjà, confirmez qu’il s’agit de votre base d’apprentissage. Si la table event_runs ou l’événement record_run existe, examinez-le avant de répéter sa création ; ne supprimez pas un objet inconnu pour libérer son nom.

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');

La clause DISABLE empêche l’exécution avant l’examen de la définition. ON COMPLETION PRESERVE conserve la définition de cet événement ponctuel après la fin de sa planification. Elle ne constitue ni une règle de conservation des données ni une garantie de nouvelle tentative en cas d’échec. La référence CREATE EVENT précise ces options.

Contrôlez l’état du planificateur, celui de l’événement et les lignes de résultat :

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;

Au départ, une seule définition doit apparaître, avec STATUS = DISABLED, et la table de résultat doit être vide. Vous pouvez inspecter la définition même lorsque le planificateur est arrêté. Vérifiez le nom, le schéma et le fuseau horaire avant toute activation.

Fixer une nouvelle date future et vérifier le résultat réel

Les dix secondes prévues dans la définition initiale ont pu passer pendant la lecture ou la connexion. Replanifiez l’exécution dans le futur au moment de l’activer, au lieu de réutiliser une date ponctuelle déjà passée :

ALTER EVENT appops_lab.record_run
  ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 10 SECOND
  ENABLE;

Après environ dix secondes, relancez les requêtes d’inspection de la section précédente. Le planificateur n’est pas une horloge temps réel stricte : une égalité exacte à la seconde près n’est pas le critère de réussite. Vous devez trouver une ligne portant l’étiquette scheduled-check et une valeur LAST_EXECUTED renseignée. L’événement ponctuel conservé devient ensuite désactivé.

LAST_EXECUTED est un indice de tentative d’exécution, pas une preuve indépendante que tout le travail métier a réussi. Comparez aussi la ligne réellement insérée. Chaque exécution utilise une connexion séparée ; le nombre de lignes affectées dans votre client courant ne permet donc pas non plus d’affirmer que la tâche planifiée s’est exécutée.

Limiter un essai récurrent et prévoir les reprises

Après avoir observé le passage ponctuel, cette modification permet d’essayer une répétition avec une date de fin. La borne évite d’oublier un travail d’exercice actif indéfiniment :

ALTER EVENT appops_lab.record_run
  ON SCHEDULE EVERY 1 MINUTE
  STARTS CURRENT_TIMESTAMP + INTERVAL 1 MINUTE
  ENDS CURRENT_TIMESTAMP + INTERVAL 3 MINUTE
  ENABLE;

La définition démarre dans une minute et se termine trois minutes après la modification. Relancez les requêtes d’inspection pour suivre les lignes ajoutées, puis désactivez votre événement avant le nettoyage. Ne déduisez pas un nombre exact d’exécutions d’une simple attente chronométrée : examinez les dates et les résultats effectivement enregistrés.

Le corps de l’exemple ajoute une ligne à chaque passage. Un récapitulatif réel doit au contraire définir une clé unique pour sa période et une politique explicite de reprise. Recalculer cette période depuis les données sources, ou rendre l’opération idempotente — une répétition conservant le même résultat métier — évite d’ajouter deux fois le même total. Évaluez également les chevauchements si une exécution peut durer plus longtemps que son intervalle.

Les limites du planificateur MariaDB concernent notamment les délais, l’ordre des tâches et les connexions d’exécution distinctes. En réplication ou lors d’un basculement, décidez quel serveur est propriétaire du travail planifié afin d’éviter qu’il s’exécute involontairement sur plusieurs serveurs.

Arrêter, diagnostiquer et nettoyer les objets d’exercice

ALTER EVENT appops_lab.record_run DISABLE;
SHOW CREATE EVENT appops_lab.record_run;
  1. Désactivez les passages futurs et confirmez que le travail est arrêté. Désactiver la planification ne garantit pas l’annulation immédiate d’une exécution déjà en cours.
  2. Examinez l’état du planificateur, STATUS, les droits du DEFINER, TIME_ZONE et les dates. Si LAST_EXECUTED change sans le résultat attendu, inspectez le journal d’erreurs du serveur et les conditions d’échec du SQL exécuté.
  3. Quand les résultats peuvent être abandonnés, supprimez l’événement avant sa table de résultat, uniquement dans cet environnement d’exercice.
DROP EVENT appops_lab.record_run;
DROP TABLE appops_lab.event_runs;

Dans la connexion où la valeur initiale a été enregistrée, rétablissez aussi le fuseau de session :

SET SESSION time_zone = @event_saved_time_zone;

Les suppressions d’objets ne sont pas récupérées par un ROLLBACK ordinaire. En cas d’échec d’un travail récurrent, arrêtez-le puis établissez la cause et le périmètre à retraiter avant de modifier une définition active : sinon, les travaux manquants deviennent difficiles à distinguer des travaux exécutés deux fois.