Corso MariaDB / Pianificare attività con Event Scheduler e verificarne i risultati

L'Event Scheduler di MariaDB esegue SQL a un momento o intervallo programmato. Definizione dell'evento, scheduler attivo e risultato corretto del lavoro sono condizioni distinte: controllare sia i metadati della pianificazione sia i dati effettivamente prodotti.

Scegliere compito e account di esecuzione

Gli eventi possono mantenere un breve riepilogo interno o svolgere pulizie circoscritte. Chiamate a interfacce esterne, trasferimenti di file, tentativi e notifiche tra sistemi possono essere più adatti a processi applicativi o scheduler operativi. L'esercizio aggiunge registrazioni di esecuzione anziché eliminare dati, rendendo osservabile il risultato.

Usare appops_lab con CREATE TABLE, INSERT ed EVENT per l'account di studio. Un evento viene eseguito con i privilegi del DEFINER, l'account che lo definisce. La connessione client corrente non svolge il compito al suo posto: modifiche dell'account o dei privilegi possono influire sulle esecuzioni successive. La panoramica ufficiale degli eventi MariaDB spiega rapporto tra scheduler e oggetti evento.

Controllare scheduler e fuso orario

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

Lo scheduler deve essere ON per eseguire le pianificazioni. OFF permette di conservare definizioni senza eseguirle. DISABLED richiede un controllo della configurazione di avvio e delle regole amministrative: non presumere che basti impostare ON a server avviato. Attivare lo scheduler globale su un server condiviso può attivare anche altri eventi.

Soltanto su un nuovo server dedicato a questa prova, l'amministratore può abilitarlo se necessario con SET GLOBAL event_scheduler = ON;. Registrare lo stato iniziale. Alla fine disabilitare prima l'evento dell'esercizio e valutare l'effetto sugli altri compiti prima di spegnere nuovamente lo scheduler globale.

Lo script usa il fuso di sessione +00:00, offset UTC zero, per rendere esplicita l'interpretazione del programma. Salvare il valore precedente e ripristinarlo al termine. Orologio e fuso visualizzati sul client non coincidono necessariamente con il contesto di pianificazione del server.

Creare tabella dei risultati e definizione disabilitata

Controllare server, database e oggetti esistenti. Conservare gli altri esercizi in appops_lab e accertare che event_runs e record_run non siano già usati.

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 impedisce l'esecuzione prima della revisione. ON COMPLETION PRESERVE conserva la definizione dell'evento singolo dopo la pianificazione; non definisce conservazione dei dati né garantisce tentativi successivi. Il riferimento di CREATE EVENT descrive pianificazione e comportamento finale.

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;

Inizialmente deve esistere un evento con STATUS DISABLED e la tabella dei risultati deve essere vuota. È possibile esaminare la definizione anche con scheduler spento. Controllare nome, database e fuso prima di abilitarla.

Impostare un nuovo momento futuro e verificare il risultato

I dieci secondi di CREATE possono essere già trascorsi durante la lettura o l'apertura della connessione. Quando si abilita l'evento, riprogrammarlo nel futuro anziché usare un istante singolo scaduto.

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

Dopo circa dieci secondi rieseguire il blocco di verifica. Lo scheduler non è un timer preciso in tempo reale: l'uguaglianza al secondo con l'orologio non è il criterio di successo. Attendersi una riga con scheduled-check, cioè controllo programmato, e LAST_EXECUTED valorizzato. L'evento singolo conservato passa a DISABLED dopo il completamento.

LAST_EXECUTED indica un tentativo di esecuzione e non dimostra da solo il successo dell'intero compito. Controllare anche la riga risultante. Ogni esecuzione usa una connessione distinta, quindi neppure il conteggio delle righe interessate nella sessione client corrente prova che l'evento sia stato eseguito.

Limitare la ricorrenza e progettare i nuovi tentativi

Dopo aver osservato l'esecuzione singola, usare questa pianificazione limitata per vedere la ripetizione. Il termine evita di lasciare indefinitamente attivo il compito di prova:

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

Il corpo dell'esempio aggiunge una riga a ogni esecuzione. Un riepilogo reale richiede una chiave univoca per periodo e regole esplicite sui tentativi. Ricalcolare il periodo dalla fonte o rendere l'operazione idempotente, cioè ripetibile con lo stesso effetto finale, aiuta a evitare totali aggiunti due volte. Considerare sovrapposizioni se il compito può durare più dell'intervallo.

I limiti ufficiali degli eventi descrivono tempi, ordine e connessioni separate. Con replica o passaggio tra server definire quale server sia responsabile, evitando esecuzioni duplicate involontarie.

Fermare, diagnosticare e pulire gli oggetti di prova

ALTER EVENT appops_lab.record_run DISABLE;
SHOW CREATE EVENT appops_lab.record_run;
  1. Disabilitare le esecuzioni future e accertarsi che il lavoro già in corso sia concluso. Disabilitare la pianificazione non significa interrompere immediatamente un'esecuzione avviata.
  2. Controllare scheduler, STATUS dell'evento, privilegi DEFINER, TIME_ZONE e programma. Se LAST_EXECUTED cambia senza il risultato atteso, esaminare error log del server e condizioni di errore dell'SQL.
  3. Se i risultati sono eliminabili, rimuovere prima il proprio evento e poi la sua tabella.
DROP EVENT appops_lab.record_run;
DROP TABLE appops_lab.event_runs;
SET SESSION time_zone = @event_saved_time_zone;

Ripristinare anche il fuso originario della sessione. DROP EVENT e DROP TABLE non sono annullabili con un normale ROLLBACK. Verificare i nomi e conservare gli altri esercizi. Quando un compito ricorrente fallisce, stabilire causa e ambito di rielaborazione prima di modificare la definizione attiva, distinguendo lavoro mancato e duplicato.