MariaDB-Kurs / Regelmäßige SQL-Aufgaben mit dem Event Scheduler ausführen und prüfen

Der MariaDB Event Scheduler führt SQL zu einem festgelegten Zeitpunkt oder in einem Intervall aus. Eine vorhandene Ereignisdefinition, ein eingeschalteter Scheduler und ein erfolgreiches Arbeitsergebnis sind unterschiedliche Zustände. Prüfen Sie deshalb sowohl Planungsmetadaten als auch die tatsächlich erzeugten Daten.

Aufgabe und Ausführungskonto passend wählen

Ein Ereignis kann eine kurze datenbankinterne Zusammenfassung pflegen oder eine begrenzte Bereinigung ausführen. Externe Programmierschnittstellen, Dateiübertragungen und systemübergreifende Wiederholungen oder Meldungen können einen Anwendungsprozess oder betrieblichen Scheduler erfordern. Dieses Beispiel schreibt einen Ausführungseintrag, statt Daten zu löschen. Dadurch ist das Ergebnis unmittelbar sichtbar.

Verwenden Sie appops_lab mit CREATE TABLE, INSERT und EVENT für das Lernkonto. Ein Ereignis arbeitet mit den Rechten seines DEFINER, des definierenden Kontos. Die aktuelle Clientverbindung führt die geplante Arbeit nicht stellvertretend aus. Änderungen des Kontos oder seiner Rechte können daher spätere Ausführungen beeinflussen. Die offizielle Ereignisübersicht beschreibt Dienst und Objekte.

Schedulerzustand und Zeitzonen untersuchen

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

Der Scheduler muss für geplante Ausführungen ON sein. Bei OFF können Definitionen vorhanden sein, ohne ausgeführt zu werden. DISABLED erfordert die Prüfung von Startkonfiguration und Verwaltungsrichtlinie; ein gewöhnlicher Laufzeitwechsel auf ON genügt dann nicht. Das globale Einschalten auf einem gemeinsam genutzten Server kann außerdem andere Ereignisse aktivieren.

Nur auf einem neuen, ausschließlich für die Übung vorgesehenen Server kann dessen Administrator den Scheduler bei Bedarf mit SET GLOBAL event_scheduler = ON; einschalten. Halten Sie den ursprünglichen Zustand fest. Deaktivieren Sie am Ende zuerst das eigene Ereignis. Berücksichtigen Sie andere Aufgaben, bevor Sie den globalen Dienst wieder abschalten.

Das Skript verwendet die Sitzungszeitzone +00:00, um die Interpretation der Planung festzulegen. Speichern Sie den vorherigen Wert und stellen Sie ihn anschließend wieder her. Uhr und Anzeigezeitzone des Clientcomputers sind nicht zwingend der Planungskontext des Servers.

Ergebnistabelle und deaktivierte Definition anlegen

Prüfen Sie zuerst Server, Datenbank und bestehende Objekte. Erhalten Sie andere Übungen in appops_lab. Die Namen event_runs und record_run müssen für diese Vorbereitung frei sein.

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 verhindert eine Ausführung vor der Prüfung. ON COMPLETION PRESERVE erhält die Definition eines einmaligen Ereignisses nach Abschluss seiner Planung. Es ist weder eine Aufbewahrungsregel für Daten noch eine Zusicherung erneuter Versuche. Die CREATE-EVENT-Referenz erläutert Zeitplanung und Abschlussverhalten.

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;

Anfangs muss ein Ereignis mit STATUS DISABLED vorhanden und die Ergebnistabelle leer sein. Die Definition lässt sich auch bei ausgeschaltetem Scheduler untersuchen. Prüfen Sie Namen, Datenbank und Zeitzone vor dem Aktivieren.

Einen neuen zukünftigen Zeitpunkt setzen und das Ergebnis prüfen

Die zehn Sekunden aus CREATE können während des Lesens oder Verbindungsaufbaus vergehen. Setzen Sie beim Aktivieren einen frischen zukünftigen Zeitpunkt, statt den abgelaufenen Termin wiederzuverwenden.

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

Wiederholen Sie nach ungefähr zehn Sekunden den Prüfungsblock. Der Scheduler ist kein exakter Echtzeittimer; eine sekundengenaue Übereinstimmung mit der Uhr ist kein Erfolgskriterium. Erwartet werden eine Zeile mit scheduled-check, also „geplante Prüfung“, und ein Wert in LAST_EXECUTED. Das erhaltene einmalige Ereignis wird nach Abschluss DISABLED.

LAST_EXECUTED weist auf einen Ausführungsversuch hin und belegt allein keine vollständige fachliche Aufgabenerfüllung. Prüfen Sie auch die Ergebniszeile. Jede Ausführung nutzt eine eigene Verbindung. Die Anzahl betroffener Zeilen der aktuellen Clientsitzung belegt deshalb ebenfalls keine Ereignisausführung.

Wiederholungen begrenzen und erneute Versuche planen

Nach der einmaligen Ausführung können Sie mit dieser begrenzten Planung Wiederholungen beobachten. Ein ausdrückliches Ende verhindert eine unbegrenzt aktive Übungsaufgabe:

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

Der Beispielkörper fügt pro Ausführung eine Zeile hinzu. Eine echte Zusammenfassung benötigt einen eindeutigen Schlüssel für ihren Berichtszeitraum und eine Regel für Wiederholungen. Eine Neuberechnung aus Quelldaten oder eine anderweitig idempotente Operation, deren Wiederholung denselben Effekt erhält, verhindert doppelt addierte Summen. Prüfen Sie auch überlappende Ausführungen, wenn die Arbeit länger als das Intervall dauern kann.

Die offiziellen Ereignisbeschränkungen beschreiben Zeitverhalten, Reihenfolge und getrennte Verbindungen. Legen Sie bei Replikation und Serverwechsel fest, welcher Server die Aufgabe besitzt, damit sie nicht unbeabsichtigt mehrfach läuft.

Anhalten, diagnostizieren und die Übung entfernen

ALTER EVENT appops_lab.record_run DISABLE;
SHOW CREATE EVENT appops_lab.record_run;
  1. Deaktivieren Sie zukünftige Ausführungen und prüfen Sie, dass die laufende Arbeit beendet ist. Eine deaktivierte Planung beendet eine bereits laufende Ausführung nicht zwangsläufig sofort.
  2. Prüfen Sie Schedulerzustand, STATUS, DEFINER-Rechte, TIME_ZONE und Termine. Ändert sich LAST_EXECUTED ohne das gewünschte Ergebnis, untersuchen Sie Serverfehlerprotokoll und Fehlerbedingungen des SQL-Körpers.
  3. Entfernen Sie bei entbehrlichen Ergebnissen zuerst das eigene Ereignis und danach dessen Übungstabelle.
DROP EVENT appops_lab.record_run;
DROP TABLE appops_lab.event_runs;
SET SESSION time_zone = @event_saved_time_zone;

Stellen Sie auch die ursprüngliche Sitzungszeitzone wieder her. DROP EVENT und DROP TABLE sind nicht durch ein gewöhnliches ROLLBACK rückgängig zu machen. Prüfen Sie die Namen und erhalten Sie andere Übungen in appops_lab. Bestimmen Sie bei einer fehlgeschlagenen periodischen Aufgabe zuerst Ursache und Nachverarbeitungsumfang, bevor Sie eine aktive Definition ändern. Sonst lassen sich ausgelassene und doppelte Arbeit schwer unterscheiden.