MySQL中的事件调度Event Scheduler

经常需要有一些定时任务在MySQL表上执行，例如统计、迁移、删除无用数据等。之前的作法是利用Linux cron定时运行脚本，但是发现这样的额外依赖有时并不方便，例如单机多实例部署时，就需要分别手动分别配置不同的cron任务，需要额外配置相应的用户和权限；新环境部署时容易遗漏cron任务等。

MySQL提供了Event Scheduler，与Linux下的crontab类似，可以根据时间调度来运行任务，运行一次或多次。

完整的Event Schduler创建语句如下：

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}

一、调度Scheduler

MySQL中的调度可以是只运行一次，也可以指定时间间隔重复运行。其定义是在event定义的ON SCHEDULE子句中。该子句格式如下：

ON SCHEDULE
AT timestamp [+ INTERVAL interval] …
| EVERY interval
    [STARTS timestamp [+ INTERVAL interval] …]
    [ENDS timestamp [+ INTERVAL interval] …]

其中，timestamp必须包括”年月日时分秒“，它参与表达式计算后，结果是datetime或者timestamp类型。

而时间间隔interval可以如下：

<数字>  {YEAR | QUARTER | MONTH | DAY | HOUR | MINUTE |
           WEEK | SECOND | YEAR_MONTH | DAY_HOUR | DAY_MINUTE |
           DAY_SECOND | HOUR_MINUTE | HOUR_SECOND | MINUTE_SECOND}

其含义很清晰，如YEAR 年；QUARTER 季度；YEAR_MONTH 年+月；MINUTE_SECOND 分钟+秒。

补充：

1. YEAR | QUARTER | MONTH | YEAR_MONTH 后台都转换成MONTH，其他时间间隔都转换成SECOND
2. ON SCHEDULE中的时间使用创建时本会话中的时区信息time_zone，这个时区默认是服务端的全局time_zone，也可能后续手动更新掉。这些时间会转化成UTC时间，存储到mysql.event表中。

1.一次运行

AT直接指定时间，或者使用时间表达式计算得出确定的时间点。

示例：

1. AT ’2006-02-10 23:59:00′   指定确切运行时间，本地时区。
2. AT current_timestamp + INTERVAL ’1:15′ MINUTE_SECOND  指定1分15秒后运行。

2.多次运行

EVERY设置运行的时间间隔，这里不能再指定[+ INTERVAL interval]。

指定STARTS、ENDS是可选的。

• STARTS是指定重复运行的第一次是什么时候。不指定的情况下，会在事件创建时运行第一次，即等价于STARTS CURRENT_TIMESTAMP！
• ENDS告知MySQL结束重复运行的时间点。不指定的情况下，MySQL会永远重复运行下去。

示例：

1. EVERY 5 WEEK  每5周运行一次，创建时运行第一次。
2. EVERY 3 DAY STARTS ’2013-12-4 09:10:00′  从’2013-12-4 09:10:00′开始运行第一次，每隔3天运行一次。
3. EVERY 2 MONTH STARTS CURRENT_TIMESTAMP + INTERVAL 10 MINUTE ENDS ’2014-12-31 23:59:59′ 10分钟后开始到2014年底，每两个月运行一次。

二、事件Event

1.启用Event Scheduler功能

Event是由一个特定的Event Scheduler线程执行的，运行过程中可以通过show full processlist查看其当前状态信息，如：

7384313     event_scheduler     localhost     [NULL]     Daemon     3     Waiting on empty queue     [NULL]

默认事件调度Event Scheduler功能是未启用的，需要配置全局参数event_scheduler，本参数可以动态设置，即时生效。

event_scheduler有如下三种取值：

• OFF/0 关闭，默认值。不运行Event Scheduler线程，也就无法进行事件调度。设置为ON可以立即启用。
• ON/1 启用。
• DISABLED 禁用。同样不运行Event Scheduler线程。只有在MySQL服务启动时设置才有用。当event_scheduler是ON或者OFF时，不能在运行时设置event_scheduler为DISABLED。如果启动时配置了event-scheduler=DISABLED，则运行时就不能设置为ON/OFF。换句话中，可以在MySQL服务启动时设置为DISABLED，然后完全禁用了event_scheduler，不能动态调整。

所以，要启用event_scheduler，运行时执行：

set global event_scheduler=on

要随MySQL服务一起启用，则在/etc/my.cnf中添加
[mysqld]
event-scheduler=on

2.CREATE EVENT

创建Event，需要所创建event的数据库下的EVENT权限。

一个event定义至少包括三部分：

1. CREATE EVENT <event_name>。<event_name>在该库中唯一，不区分大小写，最大64个字符。
2. 一个ON SCHEDULE子句。决定了event执行的周期。
3. 一个DO子句。包含了事件的SQL操作集合。

其他event子句说明：

1.  [DEFINER = { user | CURRENT_USER }]  设置运行时进行权限验证的用户，如需指定则应使用’user’@’host’格式，并需要SUPER权限。不指定则为当前用户。
2. [ON COMPLETION [NOT] PRESERVE]  默认为ON COMPLETION NOT PRESERVE，即event在完成后即自动删除。指定ON COMPLETION PRESERVE使得完成后event依然保留。
3. [ENABLE | DISABLE | DISABLE ON SLAVE]  默认为ENABLE，即创建后立即启用。可以设置为DISABLE，创建后不启用，后续使用ALTER event来控制启动、停止。DISABLE ON SLAVE是Replication环境下Slave上的event的状态，表示是Master上创建，复制到SLAVE上的，在SLAVE上无需运行。因为event内的操作会通过binlog同步到slave。
4. COMMENT 注释。

3.Do子句

在Do子句中实现事件的具体逻辑，几乎所有可以在存储程序中运行的MySQL语句都可以在event中使用。

1）简单SQL示例：
CREATE EVENT e_hourly
    ON SCHEDULE
      EVERY 1 HOUR
    COMMENT ‘Clears out sessions table each hour.’
    DO
      DELETE FROM site_activity.sessions;

2）复杂SQL示例：
delimiter |
CREATE EVENT e
    ON SCHEDULE
      EVERY 5 SECOND
    DO
      BEGIN
        DECLARE v INTEGER;
        DECLARE CONTINUE HANDLER FOR SQLEXCEPTION BEGIN END;
        SET v = 0;
        WHILE v < 5 DO
          INSERT INTO t1 VALUES (0);
          UPDATE t2 SET s1 = s1 + 1;
          SET v = v + 1;
        END WHILE;
    END |
delimiter ;

3）Do子句中SQL的限制

基本上Do中可以使用任何在存储程序(Stored Routine)中允许的SQL语句，而存储程序中有些限制，event还有些额外的限制。

Stored Routine中如下语句不允许：

1. LOCK TABLES/UNLOCK TABLES
2. LOAD DATA与LOAD TABLE
3. 支持动态SQL(PREPARE, EXECUTE, DEAALOCATE PREPARE)！但是PREPARE本身有些语句不允许执行。
4. INSERT DELAYED不会生效

EVENT的限制：

1. 如果Do子句中包含ALTER EVENT子句，虽然能够创建，但是运行时会出错。
2. 不要在Do子句中使用SELECT或SHOW这样仅仅是查询的语句，因为其输出无法从外部获取到。可以使用SELECT … INTO 这样的形式将查询结果保存起来。

4.ALTER EVENT

语法：

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]

可以看到基本支持CREATE EVENT所涉及的所有子句更新，还支持改名RENAME TO。具有event权限即可。

RENAME TO支持移动EVENT到另一个数据库，如：

ALTER EVENT olddb.myevent
     RENAME TO newdb.myevent;

此时要求有连个数据库上的event。

常用的还有：

启用、停用EVENT——ALTER EVENT myevent DISABLE/ENABLE，我们知道DISABLE ON SLAVE是Replication环境中SLAVE中event的状态，默认是自动设置的。有时需要手动设置。

5.查看EVENT

有如下方式可以查看event的信息：

• mysql.event
• information_schema.events
• show events
• show create event

6.删除EVENT

任何具有该数据库下的event权限的用户都可以删除event，不管是否是他拥有的event。

删除命令：DROP EVENT [IF EXISTS] <event name>。

三、event schedule其他注意点

1. MySQL保存了事件创建时的sql_mode作为其运行时的sql_mode;
2. 如果在一个调度区间内任务没有处理完成，新的调度依然会生成，这样就会出现同时又多个任务在运行的情况。如果要避免多个任务同时存在，可以使用GET_LOCK()函数或者行锁、表锁。

更多关于时区影响、event使用注意点，请参考文档：
http://dev.mysql.com/doc/refman/5.5/en/events.html

The post MySQL中的事件调度Event Scheduler appeared first on SQLParty.