MySQL事件

柔光的暖阳◎ 2024-03-29 15:51 72阅读 0赞

#### 文章目录 ####

*  事件介绍
 *  事件调度
 *   *  查询事件调度状态
     *  开关事件调度(临时)
     *  开关事件调度(永久)
 *  事件使用
 *   *  创建事件
     *   *  语法子句分析
         *   *  执行计划子句
             *  事件主体子句
     *  查询事件
     *  修改事件
     *  删除事件

--------------------

## 事件介绍 ##

MySQL事件(event)是根据指定时间表执行的任务，称为**计划事件**。事件包含一个或多个SQL语句的对象。一个事件可调用一次，也可周期性的启动。因为它们是由时间触发的，所以MySQL事件也称为**时间触发器**

事件和触发器相似，都是在某些事情发生的时候启动，因此事件也可称为**临时触发器**。

*  事件：基于特定时间周期触发来执行某些任务
 *  触发器：基于某个表所产生的

MySQL事件由一个特定的线程来管理的，也就是所谓的**事件调度器**。

事件调度器可以在指定的时刻执行某些特定的任务，并以此可取代原先只能由操作系统的计划任务来执行的工作。这些在指定时刻才能被执行的任务就是事件，这些任务通常是一些确定的SQL语句集合。

## 事件调度 ##

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

**事件调度核心参数：event\_scheduler**

### 查询事件调度状态 ###

以下几种方式都可以

**方式1：**

SHOW VARIABLES LIKE 'event_scheduler';

![在这里插入图片描述][c991ffc6e24c46d888d067132092d577.png]

**方式2：**

SELECT @@event_scheduler;

![在这里插入图片描述][8a35b554bc4a4e10908d351f9955ce14.png]

**方式3：**

SHOW processlist;

![在这里插入图片描述][c01e9002680543f88d27d73592f05336.png]

*  event\_scheduler=NO说明已经开启了，event\_scheduler=OFF设没开启
 *  processlist命令查看得到event\_scheduler的信息，则说明已经开启，否则没开启

### 开关事件调度(临时) ###

**1. 开启事件调度(临时)**  
以下任意命令都可以，该配置只是临时生效，重启后失效。

SET GLOBAL event_scheduler = ON;
    
    SET @@global.event_scheduler = ON;
    
    SET GLOBAL event_scheduler = 1;
    
    SET @@global.event_scheduler = 1;

**2. 关闭事件调度(临时)**  
以下任意命令都可以，该配置只是临时生效，重启后失效。

SET GLOBAL event_scheduler = OFF;
    
    SET @@global.event_scheduler = OFF;
    
    SET GLOBAL event_scheduler = 0;
    
    SET @@global.event_scheduler = 0;

### 开关事件调度(永久) ###

**上面的方式都只是临时生效，重启MySQL就会恢复之前状态**。要想永久生效需要在配置文件（my.ini）中配置参数。

event_scheduler = 1 #开启事件
    
    event_scheduler = 0 #关闭事件

MySQL8.0版本event\_scheduler默认是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;

**示例：**

CREATE DEFINER = `root`@`%` EVENT IF NOT EXISTS event1
    ON SCHEDULE EVERY 1 MONTH STARTS '2023-01-20 00:00:00' ENDS '2025-01-20 00:00:00'
    ON COMPLETION PRESERVE
    ENABLE
    COMMENT '测试事件1'
    DO BEGIN
    	INSERT INTO table1 (`id`) VALUES (12);
    END;

#### 语法子句分析 ####

<table> 
 <thead> 
  <tr> 
   <th align="left">子句</th> 
   <th align="left">是否必选</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">DEFINER</td> 
   <td align="left">可选</td> 
   <td align="left">定义事件执行时检查权限的用户</td> 
  </tr> 
  <tr> 
   <td align="left">IF NOT EXISTS</td> 
   <td align="left">可选</td> 
   <td align="left">判断要创建的事件是否存在</td> 
  </tr> 
  <tr> 
   <td align="left">EVENT event_name</td> 
   <td align="left">必选</td> 
   <td align="left">指定事件名称</td> 
  </tr> 
  <tr> 
   <td align="left">ON SCHEDULE schedule</td> 
   <td align="left">必选</td> 
   <td align="left">定义执行计划（执行的时间和时间间隔）<br><br>schedule：具体的执行计划规则</td> 
  </tr> 
  <tr> 
   <td align="left">ON COMPLETION [NOT] PRESERVE</td> 
   <td align="left">可选</td> 
   <td align="left">定义事件是否循环执行<br><br>指定事件一次执行还是永久执行，默认NOT PRESERVE：一次执行</td> 
  </tr> 
  <tr> 
   <td align="left">ENABLE | DISABLE | DISABLE ON SLAVE</td> 
   <td align="left">可选</td> 
   <td align="left">指定事件是否开启，默认ENABLE<br><br>ENABLE：开启<br>DISABLE：关闭<br>DISABLE ON SLAVE：从库中关闭</td> 
  </tr> 
  <tr> 
   <td align="left">COMMENT ‘comment’</td> 
   <td align="left">可选</td> 
   <td align="left">定义事件的注释<br><br>comment：注释内容</td> 
  </tr> 
  <tr> 
   <td align="left">DO event_body</td> 
   <td align="left">必选</td> 
   <td align="left">指定事件启动时所要执行的事件主体代码<br><br>可以是任何有效的SQL语句、存储过程或者一个计划执行的事件。如果包含多条语句，则可以使用 BEGIN…END 复合结构<br><br>event_body：执行的代码</td> 
  </tr> 
 </tbody> 
</table>

##### 执行计划子句 #####

**语法：ON SCHEDULE schedule**

*  schedule：具体的执行计划规则

**1. 一次性事件**  
语法：`AT timestamp [+ INTERVAL]`

某一时间执行一次

ON SCHEDULE AT '2023-02-01 00:00:00'
    
    ON SCHEDULE AT '2023-02-01 00:00:00' + INTERVAL 1 DAY

**2. 重复性事件**  
语法：`EVERY interval STARTS timestamp [+INTERVAL] [ENDS timestamp [+INTERVAL]]`

在开始结束时间范围内，每间隔指定时间就执行一次

EVERY 1 MONTH STARTS '2023-01-20 00:00:00' ENDS '2025-01-20 00:00:00'
    
    EVERY 1 MONTH STARTS '2023-01-20 00:00:00' + INTERVAL 1 DAY ENDS '2025-01-20 00:00:00' + INTERVAL 1 DAY

结束时间可以不指定，但开始时间必须指定。

##### 事件主体子句 #####

**语法：DO event\_body**

指定事件启动时所要执行的事件主体代码。

*  event\_body：执行的代码

可以是任何有效的SQL语句、存储过程或者一个计划执行的事件。如果包含多条语句，则可以使用 BEGIN…END 复合结构。

DO INSERT INSERT INTO time_table (`id`) VALUES (12)

### 查询事件 ###

**1. 当前数据库所有事件信息**

show events;

条件筛选

show events like '%event_name%';

**2. 指定数据库所有事件信息**

show events from demo;

条件筛选

show events from demo WHERE name like 'event_name';

3.从events表直接查询事件信息

select * from information_schema.events where EVENT_SCHEMA='demo' and EVENT_NAME='event_name';

### 修改事件 ###

**1. 启用禁用事件**

--开启事件
    alter event event_name enable;
    --关闭事件
    alter event event_name disable;

**2. 修改执行计划**

ALTER EVENT event_name ON SCHEDULE schedule;

**3. 修改事件主体**

ALTER EVENT event_name DO event_body;

**4. 重命名事件**

ALTER EVENT event_name RENAME TO new_event_name;

**5. 移动事件到其他数据库**  
可修改事件名称

ALTER EVENT demo.event_name RENAME TO test.event_name;

### 删除事件 ###

drop event event_name;

[c991ffc6e24c46d888d067132092d577.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/49f0e1e35d654d1ba94d0ed370238d85.png
[8a35b554bc4a4e10908d351f9955ce14.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/1a489dd783e648f59781fc42f548f27c.png
[c01e9002680543f88d27d73592f05336.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/28/5c463bc7be9840718a339fb880e3234f.png