在MySQL中，事件（Event）是数据库内置的任务调度机制，可以让我们在指定时间或者间隔执行特定的SQL语句。如果我们需要执行一个只运行一次、且希望创建后马上触发的任务，就可以通过配置一次性事件来实现。首先我们需要在数据库中存在一张用于演示的表，这里先创建一张测试表。
一、开启MySQL事件调度器
MySQL的事件调度器默认可能是关闭状态，我们需要先确认并开启它，否则创建的事件不会执行。可以通过下面的语句查看调度器状态：
-- 查看事件调度器状态 SHOW VARIABLES LIKE 'event_scheduler';
如果返回的结果是OFF，需要执行下面的语句开启调度器，注意该设置重启MySQL后会失效，如果需要永久生效需要修改配置文件：
-- 开启事件调度器 SET GLOBAL event_scheduler = ON;
二、创建立即执行的一次性事件
创建一次性事件的核心是设置事件的执行时间为当前时间，并且指定事件只执行一次。MySQL的事件创建语法中，通过AT子句指定执行时间，ON COMPLETION NOT PRESERVE表示事件执行完成后自动删除，也就是一次性事件。
下面的示例创建一个立即执行的一次性事件，功能是向之前创建的测试表中插入一条记录：
-- 先创建测试表
CREATE TABLE IF NOT EXISTS test_event_log (
id INT PRIMARY KEY AUTO_INCREMENT,
content VARCHAR(50),
create_time DATETIME
);
-- 创建立即执行的一次性事件
CREATE EVENT IF NOT EXISTS immediate_one_time_event
ON SCHEDULE AT CURRENT_TIMESTAMP -- 指定执行时间为当前时间，创建后立即触发
ON COMPLETION NOT PRESERVE -- 事件执行完成后自动删除，实现一次性效果
DO
INSERT INTO test_event_log (content, create_time)
VALUES ('立即执行的一次性事件触发', NOW());
上面的事件中，AT CURRENT_TIMESTAMP表示事件在创建完成的瞬间就会执行，ON COMPLETION NOT PRESERVE保证事件执行完插入操作后，自动从数据库中删除，不会重复执行。
三、验证事件执行结果
事件创建完成后，我们可以查询测试表来验证事件是否已经执行：
-- 查询测试表数据，确认事件是否执行 SELECT * FROM test_event_log;
如果表中出现了一条content为立即执行的一次性事件触发的记录，说明事件已经成功执行。
四、注意事项
- 创建事件的用户需要有
EVENT权限，否则会提示权限不足的错误。 - 如果事件创建时指定的
AT时间已经过去，事件不会执行，所以要实现立即执行必须使用CURRENT_TIMESTAMP。 - 如果需要临时禁用某个事件，可以使用
ALTER EVENT 事件名 DISABLE;语句，启用则用ENABLE替换DISABLE。 - 查看数据库中所有事件的语句是
SHOW EVENTS;，一次性事件执行完成后就会从该列表中消失。
五、带延迟的立即执行场景
如果希望事件创建后立即执行，但执行的内容需要等待一小段时间（比如1秒后执行），可以在AT子句中做时间偏移：
-- 创建1秒后执行的一次性事件
CREATE EVENT IF NOT EXISTS delay_one_time_event
ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 1 SECOND
ON COMPLETION NOT PRESERVE
DO
INSERT INTO test_event_log (content, create_time)
VALUES ('延迟1秒执行的一次性事件触发', NOW());
这种方式也属于广义的立即执行范畴，只是执行时间做了微小的偏移，适用于需要等待其他前置操作完成的场景。
MySQL_event一次性事件立即执行事件调度器修改时间：2026-06-27 00:24:18