Événement planifié MySQL : CREATE EVENT et event_scheduler

Un événement MySQL est un programme stocké que le serveur exécute tout seul à une date précise ou à intervalle régulier, sans qu'aucun client soit connecté : c'est une tâche planifiée interne à la base, comme une ligne de cron. On le crée avec CREATE EVENT … ON SCHEDULE … DO …, et il est exécuté par le planificateur d'événements (event_scheduler). Ce chapitre l'utilise pour purger les traces anciennes et calculer des statistiques mensuelles sur la base parc.

Le planificateur d'événements

Les événements sont lancés par un processus du serveur, le planificateur, réglé par la variable event_scheduler :

SHOW VARIABLES LIKE 'event_scheduler';   -- ON

Quand il tourne, le planificateur apparaît dans SHOW PROCESSLIST comme un utilisateur event_scheduler, avec l'état Waiting for next activation.

CREATE EVENT

CREATE EVENT [IF NOT EXISTS] nom_evenement
  ON SCHEDULE { AT horodatage | EVERY intervalle [STARTS horodatage] [ENDS horodatage] }
  [ON COMPLETION [NOT] PRESERVE]
  [ENABLE | DISABLE | DISABLE ON REPLICA]
  [COMMENT 'texte']
  DO instruction;   -- ou un bloc BEGIN … END

• AT : une seule exécution, à la date donnée. AT CURRENT_TIMESTAMP + INTERVAL 1 HOUR : dans une heure.
• EVERY : une exécution récurrente, EVERY 1 DAY, EVERY 1 MONTH, EVERY 15 MINUTE… STARTS fixe la première exécution (donc l'heure des suivantes), ENDS la dernière possible.
• ON COMPLETION NOT PRESERVE (par défaut) : un événement terminé (le AT passé, ou le ENDS atteint) est supprimé automatiquement. PRESERVE le garde, désactivé, pour garder la trace de sa définition.
• DISABLE ON REPLICA : sur un serveur répliqué, l'événement ne s'exécute que sur le serveur source, pas sur les copies, qui reçoivent déjà ses effets par la réplication.

Créer un événement demande le privilège EVENT sur la base. Comme un trigger, un événement s'exécute avec les droits de son propriétaire (DEFINER), dans une connexion qui lui est propre : les variables de session d'un client n'y existent pas.

Purger les traces anciennes

Les tables d'audit du chapitre 9 grandissent sans fin, et elles contiennent des données personnelles : le RGPD impose une durée de conservation, que Sorbier Logistique fixe à un an. Chaque nuit à 3 heures, un événement supprime les traces plus anciennes :

DELIMITER //
CREATE EVENT ev_purge_audit
  ON SCHEDULE EVERY 1 DAY STARTS '2026-11-09 03:00:00'
  COMMENT 'Durée de conservation des traces : 1 an'
  DO
  BEGIN
    DELETE FROM audit_ticket           WHERE modifie_le < NOW() - INTERVAL 1 YEAR;
    DELETE FROM historique_affectation WHERE modifie_le < NOW() - INTERVAL 1 YEAR;
  END //
DELIMITER ;

Le corps d'un événement suit les règles d'une procédure : BEGIN … END, variables, conditions, gestionnaires d'erreurs, et donc DELIMITER dans le client mysql. La durée de conservation choisie se documente dans le registre des traitements : c'est elle qu'un contrôle de la CNIL demanderait.

Calculer des statistiques chaque mois

Le responsable veut, chaque mois, le nombre de tickets ouverts, de tickets résolus et le temps passé du mois précédent. Le calcul va dans une procédure, que l'événement appelle : la procédure se teste et se rejoue à la main, l'événement ne fait que la planifier. Les chiffres affichés supposent la base remise à zéro au début du chapitre (voir L'essentiel) : une intervention ajoutée en essayant les exemples d'un chapitre précédent les change.

DELIMITER //
CREATE PROCEDURE calculer_stat_mois(IN p_debut DATE)
BEGIN
  DECLARE v_fin DATE DEFAULT p_debut + INTERVAL 1 MONTH;

  REPLACE INTO stat_mensuelle (mois, nb_ouverts, nb_resolus, minutes_passees, calcule_le)
  SELECT DATE_FORMAT(p_debut, '%Y-%m'),
         (SELECT COUNT(*) FROM ticket
           WHERE date_ouverture >= p_debut AND date_ouverture < v_fin),
         (SELECT COUNT(*) FROM ticket
           WHERE date_cloture >= p_debut AND date_cloture < v_fin),
         (SELECT COALESCE(SUM(duree_min), 0) FROM intervention
           WHERE date_intervention >= p_debut AND date_intervention < v_fin),
         NOW();
END //
DELIMITER ;

CALL calculer_stat_mois('2026-09-01');
CALL calculer_stat_mois('2026-10-01');
SELECT mois, nb_ouverts, nb_resolus, minutes_passees FROM stat_mensuelle ORDER BY mois;

REPLACE INTO remplace la ligne du mois si elle existe déjà (même clé primaire) : rejouer le calcul ne crée pas de doublon. Les bornes >= début et < fin comptent chaque date une fois, quelle que soit l'heure. L'événement, le 1er de chaque mois à 1 heure :

CREATE EVENT ev_stat_mensuelle
  ON SCHEDULE EVERY 1 MONTH STARTS '2026-12-01 01:00:00'
  COMMENT 'Indicateurs du mois précédent'
  DO CALL calculer_stat_mois(DATE_FORMAT(CURDATE() - INTERVAL 1 MONTH, '%Y-%m-01'));

Le 1er décembre 2026, CURDATE() - INTERVAL 1 MONTH donne le 1er novembre, et DATE_FORMAT(…, '%Y-%m-01') le premier jour de ce mois : la procédure calcule novembre. Un corps d'une seule instruction n'a pas besoin de DELIMITER.

Un événement ponctuel, pour finir : relever la priorité du ticket 14 dans une heure s'il n'est toujours pas traité.

CREATE EVENT ev_rappel_ticket_14
  ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 1 HOUR
  DO UPDATE ticket SET priorite = 'haute' WHERE id_ticket = 14 AND statut = 'ouvert';

Après son exécution, il disparaît (ON COMPLETION NOT PRESERVE).

Surveiller, modifier, supprimer

SHOW EVENTS FROM parc;

SELECT event_name, status, event_type, interval_value, interval_field, starts, last_executed
FROM information_schema.events
WHERE event_schema = 'parc'
ORDER BY event_name;

LAST_EXECUTED vaut NULL tant que l'événement n'a jamais tourné : c'est la colonne à surveiller. Pour modifier un événement, ALTER EVENT accepte toutes les clauses de CREATE EVENT :

ALTER EVENT ev_purge_audit DISABLE;                                    -- suspendre
ALTER EVENT ev_purge_audit ENABLE;                                     -- reprendre
ALTER EVENT ev_purge_audit ON SCHEDULE EVERY 1 DAY STARTS '2026-11-09 04:00:00';
DROP EVENT IF EXISTS ev_rappel_ticket_14;

Événement MySQL ou tâche cron ?

Un événement convient à une tâche purement SQL sur la base : purge, statistiques, archivage d'une table dans une autre. Une sauvegarde avec mysqldump, un export de fichier ou une tâche qui touche d'autres serveurs reste une tâche cron (automatiser les sauvegardes ; planifier une tâche sous Linux).

Exercices

CREATE EVENT ev_purge_erreurs
  ON SCHEDULE EVERY 1 WEEK STARTS '2026-11-15 02:00:00'
  COMMENT 'Conservation des erreurs : 90 jours'
  DO DELETE FROM journal_erreur WHERE survenue_le < NOW() - INTERVAL 90 DAY;

CREATE EVENT ev_relance_hebdo
  ON SCHEDULE EVERY 1 WEEK STARTS '2026-11-09 07:00:00'
  DO CALL relancer_tickets(NOW(), 14, @nb_relances);

CREATE EVENT ev_archive
  ON SCHEDULE AT '2026-11-10 13:00:00'
  DO INSERT INTO ticket_archive SELECT * FROM ticket WHERE statut = 'resolu';