如何在mysql中配置事件调度器

mysql的事件调度器是数据库自带的定时任务组件，能够按照设定的时间周期自动执行指定的sql操作，适合处理定期数据清理、状态更新、报表生成等重复性任务，不需要依赖外部定时工具即可实现自动化运维。

开启mysql事件调度器

mysql的事件调度器默认可能是关闭状态，首先需要确认当前调度器的运行状态，再根据实际情况开启。可以通过执行以下sql语句查看状态：

-- 查看事件调度器状态
SHOW VARIABLES LIKE 'event_scheduler';

如果返回的结果中Value字段为OFF，说明调度器未开启，可以通过以下两种方式开启：

临时开启（重启后失效）

执行以下sql语句即可临时开启，仅对当前mysql实例生效，重启服务后会恢复默认状态：

-- 临时开启事件调度器
SET GLOBAL event_scheduler = ON;

永久开启（重启后生效）

如果需要调度器永久开启，需要修改mysql的配置文件，不同系统的配置文件路径不同，windows系统一般是my.ini，linux系统一般是/etc/my.cnf或者/etc/mysql/my.cnf，在配置文件的[mysqld]模块下添加以下内容：

[mysqld]
event_scheduler=ON

修改完成后重启mysql服务即可生效。

创建事件调度任务

开启调度器后，就可以创建具体的事件任务了，创建事件的基本语法如下：

CREATE EVENT [IF NOT EXISTS] 事件名称
ON SCHEDULE 调度规则
[ON COMPLETION [NOT] PRESERVE]
[ENABLE | DISABLE]
DO
事件执行内容;

其中各个参数的含义如下：

• IF NOT EXISTS：可选参数，避免事件名称重复时报错
• 调度规则：指定任务的执行时间，支持两种类型，一种是AT 具体时间，表示在指定时间执行一次；另一种是EVERY 时间间隔 [STARTS 开始时间] [ENDS 结束时间]，表示按照固定周期重复执行
• ON COMPLETION PRESERVE：表示事件执行完成后不会被删除，默认是ON COMPLETION NOT PRESERVE，即一次性事件执行完成后自动删除
• ENABLE | DISABLE：指定事件创建后是启用还是禁用状态，默认是启用
• DO后面内容：事件要执行的具体sql语句，如果有多条语句可以用BEGIN和END包裹

一次性事件示例

创建一个在2024-10-01 00:00:00执行的一次性事件，删除test库中30天前的过期日志：

-- 创建一次性事件
CREATE EVENT IF NOT EXISTS clear_old_log
ON SCHEDULE AT '2024-10-01 00:00:00'
ON COMPLETION NOT PRESERVE
DO
DELETE FROM test.log_table WHERE create_time < DATE_SUB(NOW(), INTERVAL 30 DAY);

周期性事件示例

创建一个每天凌晨2点执行的周期性事件，自动更新用户表的活跃状态：

-- 创建周期性事件
CREATE EVENT IF NOT EXISTS update_user_active
ON SCHEDULE EVERY 1 DAY STARTS '2024-01-01 02:00:00'
ON COMPLETION PRESERVE
ENABLE
DO
UPDATE test.user SET is_active = 0 WHERE last_login_time < DATE_SUB(NOW(), INTERVAL 7 DAY);

事件的管理操作

创建好的事件可以通过以下语句进行管理：

查看已有事件

可以查看当前数据库或者所有数据库的事件列表：

-- 查看当前数据库的所有事件
SHOW EVENTS;
-- 查看指定数据库的事件
SHOW EVENTS FROM test;

修改事件状态

如果需要临时禁用或者重新启用某个事件，可以使用ALTER EVENT语句：

-- 禁用事件
ALTER EVENT update_user_active DISABLE;
-- 启用事件
ALTER EVENT update_user_active ENABLE;

修改事件内容

也可以修改事件的执行规则或者执行内容：

-- 修改事件的执行周期为每12小时一次
ALTER EVENT update_user_active
ON SCHEDULE EVERY 12 HOUR;

删除事件

如果不再需要某个事件，可以使用DROP EVENT语句删除：

-- 删除指定事件
DROP EVENT IF EXISTS clear_old_log;

配置注意事项

在配置和使用mysql事件调度器时，需要注意以下几点：

• 事件调度器依赖mysql服务运行，如果mysql服务停止，所有定时事件都会暂停，服务恢复后会继续执行未执行的周期性事件，但一次性事件如果错过执行时间则不会再执行
• 创建事件的用户需要有EVENT权限，否则无法创建、修改或者删除事件，可以通过以下语句授予权限：GRANT EVENT ON test.* TO 'user'@'localhost';
• 如果事件执行内容包含多条sql语句，需要用BEGIN和END包裹，并且事件定义者需要有对应语句的执行权限
• 周期性事件的开始时间和结束时间如果不指定，开始时间默认是当前时间，没有结束时间则永久执行

注意：如果mysql运行在严格模式下，事件的时间参数需要符合对应的时间格式，否则会创建失败，建议先测试调度规则是否符合预期再正式使用。

mysql事件调度器event_scheduler定时任务数据库配置修改时间：2026-07-22 17:15:34