MySQL 事件調度器啟用與定時任務實戰指南

事件調度器核心操作

1. 檢查/啟用調度器

-- 查看狀態 (OFF/ON/DISABLED)
SHOW VARIABLES LIKE 'event_scheduler';

-- 運行時動態啟用 (重啟失效)
SET GLOBAL event_scheduler = ON;

-- 永久生效：my.cnf [mysqld] 區段
event_scheduler = ON

2. 創建存儲過程 (業務邏輯載體)

DELIMITER //
CREATE PROCEDURE `update_project_time`()
BEGIN
    UPDATE `project` SET `create_time` = NOW();
END //
DELIMITER ;

3. 創建事件 (定時觸發器)

CREATE EVENT `e_update_project_time`
ON SCHEDULE EVERY 30 SECOND
ON COMPLETION PRESERVE
DO CALL `update_project_time`();

關鍵子句：

• ON SCHEDULE：AT timestamp (一次性) / EVERY interval (循環)。interval: SECOND/MINUTE/HOUR/DAY/WEEK/MONTH/QUARTER/YEAR。
• ON COMPLETION PRESERVE：完成後保留事件 (默認 DROP)，循環事件必加。
• ENABLE/DISABLE：創建時指定啟用狀態。

4. 事件控制

-- 啟用/禁用
ALTER EVENT `e_update_project_time` ENABLE;
ALTER EVENT `e_update_project_time` DISABLE;

-- 修改調度
ALTER EVENT `e_update_project_time` ON SCHEDULE EVERY 1 MINUTE;

-- 刪除
DROP EVENT `e_update_project_time`;

-- 查看事件
SHOW EVENTS FROM `db_name`;
SHOW CREATE EVENT `e_update_project_time`;

進階調度模式

權限要求

• 創建事件：EVENT 權限 (5.1.6+)。
• 調度器進程：以 event_scheduler 系統線程運行，**權限為 DEFINER 賬號權限**，非調用者權限。
• 最佳實踐：專用事件賬號 'event_user'@'localhost'，僅授予所需表 INSERT/UPDATE/DELETE。

避坑指南

1. 時區一致性：事件按 system_time_zone / time_zone 執行，跨時區部署需統一設定 SET time_zone = '+08:00';。
2. 長事務阻塞：事件內避免長事務，阻塞主業務。大批量操作分批提交。
3. 異常處理：存儲過程內 DECLARE CONTINUE HANDLER FOR SQLEXCEPTION BEGIN ... END; 記錄錯誤日志，防止事件靜默失敗。
4. 并發衝突：同一事件並發執行 (上次未結束) 會**排隊等待**，不會並行。長任務需評估間隔。
5. 備份還原：mysqldump --events 導出事件，還原時需 event_scheduler=ON 自動恢復調度。

監控與排查

-- 事件執行狀態
SELECT * FROM information_schema.EVENTS WHERE EVENT_SCHEMA='db_name'\G

-- 最近執行時間
SELECT EVENT_NAME, LAST_EXECUTED, STATUS FROM information_schema.EVENTS;

-- 錯誤日志
-- 事件報錯寫入 mysqld error log，關注 [ERROR] Event Scheduler: ...

總結

MySQL Event Scheduler 是資料庫層面的輕量級定時任務引擎，**適合「數據庫內部」周期性維護 (清理、統計、分區、同步)**。複雜業務調度 (依賴外部 API、多步驟編排、失敗重試) 應遷移至應用層調度器 (xxl-job, Airflow, Celery Beat)。啟用 event_scheduler=ON、善用 ON COMPLETION PRESERVE、嚴格權限控制、完善異常日志，是生產可用的關鍵。