MySQL 事件排程器：建立、啟用與定時任務實戰範例

前置準備：建立測試表

CREATE TABLE t (
    v VARCHAR(100) NOT NULL
) ENGINE=INNODB DEFAULT CHARSET=utf8;

建立被呼叫的預存程序

DELIMITER $$
DROP PROCEDURE IF EXISTS e_test $$
CREATE PROCEDURE e_test()
BEGIN
    INSERT INTO t VALUES('1');
END $$
DELIMITER ;

啟用事件排程器

MySQL 全域變數 event_scheduler 必須設為 ON 或 1，事件才會生效。

-- 查看是否啟用
SHOW VARIABLES LIKE '%sche%';

-- 啟用事件排程器
SET GLOBAL event_scheduler = 1;

建立與管理事件

基本語法

CREATE EVENT [IF NOT EXISTS] event_name
ON SCHEDULE schedule
[ON COMPLETION [NOT] PRESERVE]
[ENABLE | DISABLE | DISABLE ON SLAVE]
DO sql_statement;

常見排程範例

每秒執行一次

CREATE EVENT IF NOT EXISTS event_test
ON SCHEDULE EVERY 1 SECOND
ON COMPLETION PRESERVE
DO CALL e_test();

-- 啟用事件
ALTER EVENT event_test ON COMPLETION PRESERVE ENABLE;

-- 停用事件
ALTER EVENT event_test ON COMPLETION PRESERVE DISABLE;

每 9 天執行一次（從現在開始）

CREATE EVENT EVENT1
ON SCHEDULE EVERY 9 DAY STARTS NOW()
ON COMPLETION PRESERVE ENABLE
DO
BEGIN
    CALL TOTAL();
END;

每月 1 號凌晨 1 點執行

CREATE EVENT EVENT2
ON SCHEDULE EVERY 1 MONTH 
STARTS DATE_ADD(DATE_ADD(DATE_SUB(CURDATE(), INTERVAL DAY(CURDATE())-1 DAY), INTERVAL 1 MONTH), INTERVAL 1 HOUR)
ON COMPLETION PRESERVE ENABLE
DO
BEGIN
    CALL STAT();
END;

每季度第一天凌晨 2 點執行

CREATE EVENT TOTAL_SEASON_EVENT
ON SCHEDULE EVERY 1 QUARTER 
STARTS DATE_ADD(DATE_ADD(DATE(CONCAT(YEAR(CURDATE()),'-',ELT(QUARTER(CURDATE()),1,4,7,10),'-',1)), INTERVAL 1 QUARTER), INTERVAL 2 HOUR)
ON COMPLETION PRESERVE ENABLE
DO
BEGIN
    CALL SEASON_STAT();
END;

每年 1 月 1 號凌晨 4 點執行

CREATE EVENT TOTAL_YEAR_EVENT
ON SCHEDULE EVERY 1 YEAR 
STARTS DATE_ADD(DATE(CONCAT(YEAR(CURDATE()) + 1,'-',1,'-',1)), INTERVAL 4 HOUR)
ON COMPLETION PRESERVE ENABLE
DO
BEGIN
    CALL YEAR_STAT();
END;

測試技巧

測試月、季、年排程時，可將系統時間暫時調整為該週期的最後一天（如 2010-12-31 23:59:55），觀察事件是否正確觸發。