MySQL事件（定时任务）

逃离我推掉我的手 2021-09-17 18:32 600阅读 0赞

# 1、事件概述 #

在MySQL 5.1中新增了一个特色功能事件调度器（Event Scheduler），简称事件。它可以作为定时任务调度器，取代部分原来只能用操作系统的计划任务才能执行的工作。另外，更值得一提的是，MySQL的事件可以实现每秒钟执行一个任务，这在一些对实时性要求较高的环境下是非常实用的。

事件调度器是定时触发执行的，从这个角度上看也可以称作是“临时触发器”。但是它与触发器又有所区别，触发器只针对某个表产生的事件执行一些语句，而事件调度器则是在某一段（间隔）时间执行一些语句。

## 1.1 查看事件调度器是否开启 ##

事件由一个特定的线程来管理。启用事件调度器后，拥有SUPER权限的账户执行SHOW PROCESSLIST就可以看到这个线程了。

**示例：**查看事件是否开启。

SHOW VARIABLES LIKE 'event_scheduler';
    SELECT @@event_scheduler;
    SHOW PROCESSLIST;

## 1.2 开启或关闭事件调度器 ##

通过设定全局变量event\_scheduler的值即可动态的控制事件调度器是否启用。开启MySQL的事件调度器，可以通过下面两种方式实现。

### 1.2.1 通过设置全局参数 ###

使用SET GLOBAL命令可以开启或关闭事件。将event\_scheduler参数的值设置为ON，则开启事件；如果设置为OFF，则关闭事件。

**示例：**使用SET GLOBAL命令可以开启或关闭事件。

-- 开启事件调度器
    SET GLOBAL event_scheduler = ON;
    
    -- 关闭事件调度器
    SET GLOBAL event_scheduler = OFF;
    
    -- 查看事件调度器状态
    SHOW VARIABLES LIKE 'event_scheduler';

**注意：**如果想要始终开启事件，那么在使用SET GLOBAL开启事件后，还需要在my.ini（Windows系统）/my.cnf（Linux系统）中添加event\_scheduler=on。因为如果没有添加，MySQL重启事件后又会回到原来的状态。

### 1.2.2 通过更改配置文件 ###

在MySQL的配置文件my.ini（Windows系统）/my.cnf（Linux系统）中，找对\[mysqld\]，然后在下面添加以下代码开启事件。

# 事件调度器启动状态
    event_scheduler = on

在配置文件中添加代码并保存文件后，还需要重新启动MySQL服务器才能生效。通过该方法开启事件，重启MySQL服务器后，不恢复为系统默认的状态。

# 2、创建事件 #

在MySQL 5.1以上版本中，可以通过CREATE EVENT语句来创建事件。

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;

**CREATE EVENT语句的子句：**

<table> 
 <thead> 
  <tr> 
   <th style="width:185px;">子句</th> 
   <th style="width:614px;">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:185px;">DEFINER</td> 
   <td style="width:614px;">可选，用于定义事件执行时检查权限的用户</td> 
  </tr> 
  <tr> 
   <td style="width:185px;">IF NOT EXISTS</td> 
   <td style="width:614px;">可选项，用于判断要创建的事件是否存在</td> 
  </tr> 
  <tr> 
   <td style="width:185px;">EVENT event_name</td> 
   <td style="width:614px;">必选，用于指定事件名，event_name的最大长度为64个字符，如果为指定event_name，则默认为当前的MySQL用户名（不区分大小写）</td> 
  </tr> 
  <tr> 
   <td style="width:185px;">ON SCHEDULE schedule</td> 
   <td style="width:614px;">必选，用于定义执行的时间和时间间隔</td> 
  </tr> 
  <tr> 
   <td style="width:185px;">ON COMPLETION [NOT] PRESERVE</td> 
   <td style="width:614px;"> <p>可选，用于定义事件是否循环执行，即是一次执行还是永久执行，默认为一次执行，</p> <p>即 NOT PRESERVE</p> </td> 
  </tr> 
  <tr> 
   <td style="width:185px;">ENABLE | DISABLE | DISABLE ON SLAVE</td> 
   <td style="width:614px;">可选项，用于指定事件的一种属性。其中，关键字ENABLE表示该事件是活动的，也就是调度器检查事件是否必选调用；关键字DISABLE表示该事件是关闭的，也就是事件的声明存储到目录中，但是调度器不会检查它是否应该调用；关键字DISABLE ON SLAVE表示事件在从机中是关闭的。如果不指定这三个选择中的任意一个，则在一个事件创建之后，它立即变为活动的。</td> 
  </tr> 
  <tr> 
   <td style="width:185px;">COMMENT 'comment'</td> 
   <td style="width:614px;">可选，用于定义事件的注释</td> 
  </tr> 
  <tr> 
   <td style="width:185px;">DO event_body</td> 
   <td style="width:614px;"> <p>必选，用于指定事件启动时所要执行的代码。可以是任何有效的SQL语句、存储过程或者一个计划执行的事件。如果包含多条语句，可以使用BEGIN...END复合结构</p> </td> 
  </tr> 
 </tbody> 
</table>

在ON SCHEDULE子句中，参数schedule的值为一个AS子句，用于指定事件在某个时刻发生，其语法格式如下：

AT timestamp [+ INTERVAL interval] ...
      | EVERY interval
        [STARTS timestamp [+ INTERVAL interval] ...]
        [ENDS timestamp [+ INTERVAL interval] ...]

**参数说明：**

（1）timestamp：表示一个具体的时间点，后面加上一个时间间隔，表示在这个时间间隔后事件发生。

（2）EVERY子句：用于表示事件在指定时间区间内每隔多长时间发生一次，其中 SELECT子句用于指定开始时间；ENDS子句用于指定结束时间。

（3）interval：表示一个从现在开始的时间，其值由一个数值和单位构成。例如，使用“4 WEEK”表示4周；使用“‘1:10’ HOUR\_MINUTE”表示1小时10分钟。间隔的距离用DATE\_ADD()函数来支配。

interval参数值的语法格式如下：

quantity {YEAR | QUARTER | MONTH | DAY | HOUR | MINUTE |
                  WEEK | SECOND | YEAR_MONTH | DAY_HOUR | DAY_MINUTE |
                  DAY_SECOND | HOUR_MINUTE | HOUR_SECOND | MINUTE_SECOND}

**一些常用的时间间隔设置：**

（1）每隔5秒钟执行

ON SCHEDULE EVERY 5 SECOND

（2）每隔1分钟执行

ON SCHEDULE EVERY 1 MINUTE

（3）每天凌晨1点执行

ON SCHEDULE EVERY 1 DAY STARTS DATE_ADD(DATE_ADD(CURDATE(), INTERVAL 1 DAY), INTERVAL 1 HOUR)

（4）每个月的第一天凌晨1点执行

ON SCHEDULE EVERY 1 MONTH STARTS DATE_ADD(DATE_ADD(DATE_SUB(CURDATE(),INTERVAL DAY(CURDATE())-1 DAY),INTERVAL 1 MONTH),INTERVAL 1 HOUR)

（5）每 3 个月，从现在起一周后开始

ON SCHEDULE EVERY 3 MONTH STARTS CURRENT_TIMESTAMP + 1 WEEK

（6）每十二个小时，从现在起三十分钟后开始，并于现在起四个星期后结束

ON SCHEDULE EVERY 12 HOUR STARTS CURRENT_TIMESTAMP + INTERVAL 30 MINUTE ENDS CURRENT_TIMESTAMP + INTERVAL 4 WEEK

**示例1：**创建名称为event\_user的事件，用于每隔5秒钟向数据表tb\_user（用户信息表）中插入一条数据。

（1）首先创建tb\_user（用户信息表）。

-- 创建用户信息表
    CREATE TABLE IF NOT EXISTS tb_user
    (
    	id INT AUTO_INCREMENT PRIMARY KEY COMMENT '用户编号',
    	name VARCHAR(30) NOT NULL COMMENT '用户姓名',
    	create_time TIMESTAMP COMMENT '创建时间'
    ) COMMENT = '用户信息表';

（2）创建事件。

-- 创建事件
    CREATE EVENT IF NOT EXISTS event_user
    ON SCHEDULE EVERY 5 SECOND
    ON COMPLETION PRESERVE
    COMMENT '新增用户信息定时任务'
    DO INSERT INTO tb_user(name,create_time) VALUES('pan_junbiao的博客',NOW());

**执行结果：**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3Bhbl9qdW5iaWFv_size_16_color_FFFFFF_t_70][]

**示例2：**创建一个事件，实现每个月的第一天凌晨1点统计一次已经注册的会员人数，并插入到统计表中。

（1）创建名称为p\_total的存储过程，用于统计已经注册的会员人数，并插入到统计表tb\_total中。

CREATE PROCEDURE p_total()
    BEGIN
    	DECLARE n_total INT default 0;
    	SELECT COUNT(*) INTO n_total FROM db_database11.tb_user;
    	INSERT INTO tb_total (userNumber,createtime) VALUES(n_total,NOW());
    END;

（2）创建名称为e\_autoTotal的事件，用于在每个月的第一天凌晨1点调用存储过程。

CREATE EVENT IF NOT EXISTS e_autoTotal
    ON SCHEDULE EVERY 1 MONTH STARTS DATE_ADD(DATE_ADD(DATE_SUB(CURDATE(),INTERVAL DAY(CURDATE())-1 DAY),INTERVAL 1 MONTH),INTERVAL 1 HOUR)
    ON COMPLETION PRESERVE ENABLE
    DO CALL p_total();

# 3、查询事件 #

在MySQL中可以通过查询information\_schema.events表，查看已创建的事件。其语句如下：

SELECT * FROM information_schema.events;

# 4、修改事件 #

在MySQL 5.1及以后版本中，事件被创建之后，还可以使用ALTER EVENT语句修改其定义和相关属性。其语法如下：

ALTER
    	[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;

ALTER EVENT语句与CREATE EVENT语句基本相同。另外ALTER EVENT语句还有一个用法就是让一个事件关闭或再次活动。

# 5、启动与关闭事件 #

另外ALTER EVENT语句还有一个用法就是让一个事件关闭或再次活动。

**示例：**启动名称为event\_user的事件。

ALTER EVENT event_user ENABLE;

**示例：**关闭名称为event\_user的事件。

ALTER EVENT event_user DISABLE;

# 6、删除事件 #

在MySQL 5.1及以后版本中，删除已经创建的事件可以使用DROP EVENT语句来实现。

**示例：**删除名称为event\_user的事件。

DROP EVENT IF EXISTS event_user;

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3Bhbl9qdW5iaWFv_size_16_color_FFFFFF_t_70]: /images/20210724/10849f2ee3004828bf56244ee4d8290d.png