MariaDB 教程 / 使用事件调度器执行定时任务并验证结果
MariaDB 事件调度器(Event Scheduler)按指定时间或间隔执行 SQL。事件定义存在、调度器开启、业务任务成功是三个不同条件;应同时检查调度元数据与任务实际生成的数据,而不只看事件是否创建成功。
选择适合数据库内部执行的任务与账户
事件适合短小、有范围的数据库内汇总或清理。外部 API、文件传输、跨系统重试与告警,可能更适合应用 worker 或运维调度系统。本篇只插入执行记录,不删除业务数据,便于明确观察结果。
使用专用 appops_lab 和具有 CREATE TABLE、INSERT、EVENT 等所需权限的账户。事件按其 DEFINER 身份执行,并非由当前连接的客户端代为运行。定义者停用或权限改变,可能影响后续执行;参见MariaDB 事件概述,并结合账户与权限范围确认实际身份。
真实任务还需确定时区、失败日志、重试和复制切换时的执行归属。若多个服务器同时运行同一业务任务,可能重复处理;不能仅凭事件定义相同就认为调度责任已正确分配。
先检查全局调度状态与会话时区
SELECT @@GLOBAL.event_scheduler, @@GLOBAL.time_zone, @@SESSION.time_zone;
ON 才会执行预约;OFF 允许定义存在但不运行;DISABLED 则需要审查启动配置与管理员政策,不能假定普通运行时切换即可开启。在共享服务器开启全局调度器,还可能让其他事件开始执行,不能只考虑本篇。
只有在新的专用练习服务器,管理员才应按需执行 SET GLOBAL event_scheduler = ON;,并记录原值。结束前先停止自己的事件;是否恢复全局 OFF,应确认对其他任务的影响,不要把共享服务器当作可随意切换的练习实例。
创建脚本把会话时区设为 +00:00,明确预约时间含义,并保存原值以便恢复。客户端电脑显示的时间与服务器调度上下文未必一致;本例写入 UTC_TIMESTAMP(6),让结果时间有明确依据。
建立结果表,并先创建禁用的事件
先检查数据库归属、event_runs 表和 record_run 事件是否已被使用。同名对象存在时检查定义与结果,不直接覆盖。以下完整设置在 MariaDB 客户端执行;IF NOT EXISTS 不替代对已有库的检查。
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 防止事件在审查前执行;ON COMPLETION PRESERVE 让一次性事件完成后仍保留定义,便于检查。它既不是结果数据保存期限,也不保证失败后重试。具体语法参见 CREATE EVENT 文档。
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;
初始应有一条 STATUS 为 DISABLED 的定义,LAST_EXECUTED 为空,结果表没有行。即使调度器关闭,也可以检查定义。核对名称、数据库、时区和计划时间后再启用,避免把其他事件或旧结果当成本次执行证据。
重新设置未来时间,并验证真实结果
阅读和连接期间,原定义的十秒时间可能已经过去。启用时重新把执行时间设到未来,不要依赖已过期的一次性计划:
ALTER EVENT appops_lab.record_run
ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 10 SECOND
ENABLE;
约十秒后再次执行上一节检查 SQL。调度器不是严格的实时计时器,不能要求墙钟毫秒级相等。预期出现一条 run_label 为 scheduled-check 的结果行,LAST_EXECUTED 有值,保留的一次性事件完成后 STATUS 变为 DISABLED。
LAST_EXECUTED 表明发生过执行尝试,不独立证明完整业务任务成功;应核对真实结果行和业务条件。事件执行使用独立连接,当前客户端的受影响行数也不能证明预约任务已执行。若元数据变化却没有结果,应检查事件体错误、定义者权限与服务器错误日志。
为重复任务设置结束时间与重跑策略
观察一次性结果后,可用以下有界计划进行重复执行练习。它一分钟后开始,每分钟执行一次,三分钟后结束,避免遗留无限期练习任务:
ALTER EVENT appops_lab.record_run
ON SCHEDULE EVERY 1 MINUTE
STARTS CURRENT_TIMESTAMP + INTERVAL 1 MINUTE
ENDS CURRENT_TIMESTAMP + INTERVAL 3 MINUTE
ENABLE;
可以在首个重复执行后重新查询结果表,确认出现额外记录,再按下一节停止本事件。若选择观察全部时间范围,也应核对计划状态和实际结果,不以精确墙钟边界猜测执行次数。
本示例每次追加一行。真实汇总应为统计期间设置唯一键,并明确重复执行政策;按源记录重算期间结果,或让重复请求产生同样结果的幂等设计,可避免重试时把金额再加一次。还要考虑任务执行时间超过间隔时是否重叠,以及如何锁定或拒绝重复工作。
事件限制文档说明了调度精度、执行顺序及独立连接。复制和故障切换环境还需规定由哪台服务器运行任务,防止多个执行者同时处理同一期间。
停止预约、定位失败并清理练习对象
ALTER EVENT appops_lab.record_run DISABLE;
SHOW CREATE EVENT appops_lab.record_run;
- 禁用后确认不再安排新运行,并检查是否还有正在执行的调用。DISABLE 不代表立即取消已开始的任务。
- 检查全局状态、事件 STATUS、DEFINER 权限、TIME_ZONE 与计划。若 LAST_EXECUTED 更新却无预期数据,查看服务器错误日志及事件体失败条件。
- 结果不再需要时,先删除自己的事件,再删除确认可丢弃的结果表,避免预约引用已删除对象。
DROP EVENT appops_lab.record_run;
DROP TABLE appops_lab.event_runs;
SET SESSION time_zone = @event_saved_time_zone;
恢复原会话时区,并根据实际任务归属审查全局调度器原值。DROP EVENT 和 DROP TABLE 不能通过普通 ROLLBACK 恢复;清理前应备份需要保留的定义与结果。重复任务失败时先停止、定位原因和重处理范围,再改动活动定义,否则容易混淆漏处理与重复处理。




