Kursus MariaDB / Menjalankan Tugas Terjadwal dan Memeriksa Hasil Event Scheduler
Event Scheduler MariaDB menjalankan SQL pada waktu atau interval yang dijadwalkan. Definisi event yang ada, scheduler yang aktif, dan hasil pekerjaan yang benar merupakan tiga kondisi berbeda. Karena itu, periksa metadata jadwal sekaligus data yang benar-benar dihasilkan.
Pilih tugas dan akun pelaksana yang sesuai
Event dapat memelihara ringkasan singkat di dalam basis data atau melakukan pembersihan terbatas. Pemanggilan antarmuka aplikasi eksternal, transfer berkas, serta pengulangan dan notifikasi lintas sistem mungkin lebih tepat dijalankan oleh proses aplikasi atau penjadwal operasional. Latihan ini menambahkan catatan eksekusi alih-alih menghapus data sehingga hasilnya mudah diperiksa.
Gunakan appops_lab dengan hak CREATE TABLE, INSERT, dan EVENT untuk akun belajar. Event berjalan dengan hak DEFINER, yaitu akun pendefinisinya. Koneksi klien saat ini tidak melaksanakan tugas terjadwal atas nama akun tersebut, sehingga perubahan akun atau haknya dapat memengaruhi eksekusi berikutnya. Lihat ikhtisar resmi event MariaDB untuk hubungan antara scheduler dan objek event.
Periksa status scheduler dan zona waktu
SELECT @@GLOBAL.event_scheduler, @@GLOBAL.time_zone, @@SESSION.time_zone;
Scheduler harus ON agar jadwal dijalankan. OFF memungkinkan definisi tersimpan tanpa eksekusi. DISABLED memerlukan pemeriksaan konfigurasi awal dan kebijakan administrator; jangan mengasumsikan bahwa penggantian biasa menjadi ON saat server berjalan akan cukup. Mengaktifkan scheduler global pada server bersama juga dapat mengaktifkan event lain.
Hanya pada server baru yang dikhususkan untuk latihan ini, administrator dapat mengaktifkannya bila perlu dengan SET GLOBAL event_scheduler = ON;. Catat status awal. Saat selesai, nonaktifkan dahulu event milik latihan. Periksa dampaknya pada tugas lain sebelum mematikan scheduler global kembali.
Skrip berikut memakai zona waktu sesi +00:00, yaitu offset UTC nol, untuk memperjelas penafsiran jadwal. Simpan nilai sesi sebelumnya dan pulihkan setelah latihan. Jam dan zona tampilan komputer klien belum tentu sama dengan konteks penjadwalan server.
Buat tabel hasil dan definisi yang belum aktif
Periksa server, basis data, serta objek yang sudah ada. Pertahankan latihan lain pada appops_lab dan pastikan nama event_runs serta record_run belum dipakai.
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 mencegah eksekusi sebelum peninjauan. ON COMPLETION PRESERVE mempertahankan definisi event satu kali setelah jadwalnya selesai; klausa tersebut bukan aturan retensi data atau jaminan percobaan ulang. Referensi CREATE EVENT menjelaskan jadwal dan perilaku setelah penyelesaian.
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;
Pada awalnya, metadata harus berisi satu event dengan STATUS DISABLED dan tabel hasil masih kosong. Definisi dapat diperiksa walaupun scheduler sedang mati. Tinjau nama, basis data, dan zona waktunya sebelum mengaktifkan event.
Tetapkan waktu baru di masa depan dan periksa hasil aktual
Waktu sepuluh detik pada CREATE mungkin sudah lewat ketika Anda membaca atau membuka koneksi. Jadwalkan ulang ke waktu mendatang saat mengaktifkannya daripada memakai jadwal satu kali yang kedaluwarsa.
ALTER EVENT appops_lab.record_run
ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 10 SECOND
ENABLE;
Setelah kira-kira sepuluh detik, jalankan kembali blok pemeriksaan. Scheduler bukan pengatur waktu real-time yang presisi, sehingga kesamaan detik dengan jam bukan kriteria keberhasilan. Hasil yang diharapkan adalah satu baris berlabel scheduled-check, yang berarti pemeriksaan terjadwal, dan LAST_EXECUTED yang sudah terisi. Event satu kali yang definisinya dipertahankan menjadi DISABLED setelah selesai.
LAST_EXECUTED merupakan petunjuk percobaan eksekusi, bukan bukti mandiri bahwa seluruh tugas bisnis berhasil. Periksa juga baris hasilnya. Setiap eksekusi memakai koneksi terpisah, sehingga jumlah baris terpengaruh pada sesi klien saat ini juga tidak membuktikan event sudah berjalan.
Batasi percobaan berulang dan rencanakan percobaan ulang
Setelah mengamati eksekusi satu kali, gunakan jadwal terbatas ini untuk melihat pengulangan. Waktu akhir mencegah tugas latihan dibiarkan aktif tanpa batas:
ALTER EVENT appops_lab.record_run
ON SCHEDULE EVERY 1 MINUTE
STARTS CURRENT_TIMESTAMP + INTERVAL 1 MINUTE
ENDS CURRENT_TIMESTAMP + INTERVAL 3 MINUTE
ENABLE;
Isi event contoh menambah satu baris pada setiap eksekusi. Ringkasan nyata memerlukan kunci unik untuk periode pelaporan dan aturan pengulangan yang jelas. Menghitung ulang periode dari data sumber atau membuat operasi idempoten, yaitu pengulangan yang mempertahankan efek akhir yang sama, membantu mencegah total ditambahkan dua kali. Pertimbangkan pula eksekusi yang tumpang tindih jika durasi tugas dapat melebihi intervalnya.
Batasan resmi event menjelaskan waktu eksekusi, urutan, dan koneksi terpisah. Pada replikasi atau perpindahan server, tentukan server yang bertanggung jawab atas tugas agar tugas yang sama tidak berjalan ganda tanpa disengaja.
Hentikan, diagnosis, dan bersihkan objek latihan
ALTER EVENT appops_lab.record_run DISABLE;
SHOW CREATE EVENT appops_lab.record_run;
- Nonaktifkan eksekusi berikutnya dan pastikan pekerjaan yang masih berjalan sudah selesai. Menonaktifkan jadwal tidak berarti eksekusi yang sedang berjalan langsung dibatalkan.
- Periksa status scheduler, STATUS event, hak DEFINER, TIME_ZONE, serta jadwal. Jika LAST_EXECUTED berubah tanpa hasil yang diharapkan, periksa log kesalahan server dan kondisi kegagalan SQL di dalam event.
- Jika hasil latihan sudah boleh dibuang, hapus event sendiri terlebih dahulu, lalu tabel hasilnya.
DROP EVENT appops_lab.record_run;
DROP TABLE appops_lab.event_runs;
SET SESSION time_zone = @event_saved_time_zone;
Pulihkan juga zona waktu sesi awal. DROP EVENT dan DROP TABLE tidak dapat dibatalkan dengan ROLLBACK biasa. Periksa nama objek dan pertahankan latihan lain dalam appops_lab. Saat pekerjaan berulang gagal, tentukan dahulu penyebab serta cakupan pemrosesan ulang sebelum mengubah definisi aktif agar pekerjaan yang terlewat dan terduplikasi dapat dibedakan.




