1.1 前提条件
- mysql的版本 >= 5.1
对于mysql的事件的使用是有前提条件的,mysql的版本必须是5.1及以上,事件全称事件调度器(Event Scheduler), - 事件是开启的
查看是否开启(下面提供3种方式)
SHOW VARIABLES LIKE 'event_scheduler';
SELECT @@event_scheduler;
SHOW PROCESSLIST;
临时开启事件
下面只是临时的,重启mysql又会恢复到原样,要想永久开启就要修改安装包下的my.cnf或my.ini,linux下是my.cnf,windows下是my.ini。
SET GLOBAL event_scheduler = ON;
永久开启事件
在my.cnf或my.ini中的[mysqld]部分添加或修改如下内容,然后重启mysql
event_scheduler = ON
1.2 基础语法
1. 创建事件的语法
CREATE
[DEFINER = { user | CURRENT_USER }]
EVENT [IF NOT EXISTS] event_name
ON SCHEDULE schedule
[ON COMPLETION [NOT] PRESERVE]
[ENABLE | DISABLE | DISABLE ON SLAVE]
[COMMENT 'comment']
DO event_body;
schedule:
AT timestamp [+ INTERVAL interval] ...
| EVERY interval
[STARTS timestamp [+ INTERVAL interval] ...]
[ENDS timestamp [+ INTERVAL interval] ...]
interval:
quantity { YEAR | QUARTER | MONTH |
DAY | HOUR | MINUTE | WEEK |
SECOND | YEAR_MONTH |
DAY_HOUR | DAY_MINUTE |
DAY_SECOND | HOUR_MINUTE |
HOUR_SECOND | MINUTE_SECOND}
/*注:QUARTER 季度*/
创建事件详细说明:
前提:创建Event,需要所创建event的数据库下的EVENT权限。
一个event定义至少包括三部分:
- CREATE EVENT 。在该库中唯一,不区分大小写,最大64个字符。
- ON SCHEDULE子句。决定了event执行的周期。
- DO子句。包含了事件的SQL操作集合。
其他event子句说明:
- [DEFINER = { user | CURRENT_USER }]
设置运行时进行权限验证的用户,默认的定义者是root@localhost,如需指定则应使用’user’@’host’格式,并需要SUPER权限。不指定则为当前用户。
- [ON COMPLETION [NOT] PRESERVE]
默认为ON COMPLETION NOT PRESERVE,即event在完成后即自动删除。指定ON COMPLETION PRESERVE使得完成后event依然保留。
- [ENABLE | DISABLE | DISABLE ON SLAVE]
默认为ENABLE,即创建后立即启用。可以设置为DISABLE,创建后不启用,后续使用ALTER event来控制启动、停止。DISABLE ON SLAVE是Replication环境下Slave上的event的状态,表示是Master上创建,复制到SLAVE上的,在SLAVE上无需运行。因为event内的操作会通过binlog同步到slave。
- COMMENT 事件注释。
调度schedule详细说明:
MySQL中的调度可以是只运行一次,也可以指定时间间隔重复运行。其定义是在event定义的ON SCHEDULE子句中,该子句格式见上。其中,timestamp必须包括”年月日时分秒“,它参与表达式计算后,结果是datetime或者timestamp类型。
- 一次运行(定点执行)
AT直接指定时间,或者使用时间表达式计算得出确定的时间点。
示例:
AT ’2006-02-10 23:59:00′
## 指定确切运行时间,本地时区。
AT current_timestamp + INTERVAL ’1:15′ MINUTE_SECOND
## 指定1分15秒后运行。
- 多次运行(周期执行)
EVERY设置运行的时间间隔,这里不能再指定[+ INTERVAL interval]。
指定STARTS、ENDS是可选的。
STARTS是指定重复运行的第一次是什么时候。不指定的情况下,会在事件创建时运行第一次,即等价于STARTS CURRENT_TIMESTAMP!
ENDS告知MySQL结束重复运行的时间点。不指定的情况下,MySQL会永远重复运行下去。
示例:
EVERY 5 WEEK
## 每5周运行一次,创建时运行第一次。
EVERY 3 DAY STARTS ’2013-12-4 09:10:00′
## 从’2013-12-4 09:10:00′开始运行第一次,每隔3天运行一次。
EVERY 2 MONTH STARTS CURRENT_TIMESTAMP +
INTERVAL 10 MINUTE ENDS ’2014-12-31 23:59:59′
## 10分钟后开始到2014年底,每两个月运行一次。
补充:
YEAR | QUARTER | MONTH | YEAR_MONTH 后台都转换成MONTH,其他时间间隔都转换成SECOND。 ON SCHEDULE中的时间使用创建时本会话中的时区信息time_zone,这个时区默认是服务端的全局time_zone,也可能后续手动更新掉。这些时间会转化成UTC时间,存储到mysql.event表中。
2. 修改事件的语法
ALTER
[DEFINER = { user | CURRENT_USER }]
EVENT event_name
[ON SCHEDULE schedule]
[ON COMPLETION [NOT] PRESERVE]
[RENAME TO new_event_name]
[ENABLE | DISABLE | DISABLE ON SLAVE]
[COMMENT 'comment']
[DO event_body]
3. 删除事件的语法
DROP EVENT [IF EXISTS] event_name
1.3 示例
1. 创建及执行、关闭事件
delimiter $$ /*定义执行分隔符*/
CREATE DEFINER = `root`@`localhost`
EVENT IF NOT EXISTS insert_class /*事件名称*/
ON SCHEDULE EVERY 5 SECOND STARTS CURRENT_TIMESTAMP +
INTERVAL 10 SECOND ENDS '2017-01-17 23:59:59'
/* 10秒后开始到2017-01-17 23:59:59,每5秒钟运行一次。*/
ON COMPLETION PRESERVE /*完成后保存*/
DISABLE ON SLAVE /*事件只能在master触发,slave上不会触发*/
COMMENT '事件注释'
DO /*执行任务*/
BEGIN
DECLARE num INTEGER;
DECLARE CONTINUE HANDLER FOR SQLEXCEPTION BEGIN END;
SET num = 0;
WHILE num < 10 DO
INSERT INTO tb_class(class_name)
VALUES ( CONCAT( DATE_FORMAT(NOW(),'%h%i%s%-'),
CAST(num AS CHAR) ) );
SET num = num +1;
END WHILE;
END $$
delimiter ;
ALTER EVENT insert_class ENABLE; /*执行事件*/
ALTER EVENT insert_class DISABLE ON SLAVE; /*关闭事件*/