# 计划事件 在本教程中，您将了解MySQL事件调度程序以及如何创建MySQL事件以自动执行数据库任务。 MySQL事件是基于预定义的时间表运行的任务，因此有时它被称为预定事件。MySQL事件也被称为“时间触发”，因为它是由时间触发的，而不是像[触发器](http://www.yiibai.com/mysql/triggers.html)一样更新表来触发的。MySQL事件类似于UNIX中的cron作业或Windows中的任务调度程序。 您可以在许多情况下使用MySQL事件，例如优化数据库表，清理日志，归档数据或在非高峰时间生成复杂的报告。 ## MySQL事件调度器配置 MySQL使用一个名为事件调度线程的特殊线程来执行所有调度的事件。可以通过执行以下命令来查看事件调度程序线程的状态： ```sql SHOW PROCESSLIST; ``` 执行上面查询语句，得到以下结果 - ```sql mysql> SHOW PROCESSLIST; +----+------+-----------------+----------+---------+------+----------+------------------+ | Id | User | Host | db | Command | Time | State | Info | +----+------+-----------------+----------+---------+------+----------+------------------+ | 2 | root | localhost:50405 | NULL | Sleep | 1966 | | NULL | | 3 | root | localhost:50406 | yiibaidb | Sleep | 1964 | | NULL | | 4 | root | localhost:50407 | yiibaidb | Query | 0 | starting | SHOW PROCESSLIST | +----+------+-----------------+----------+---------+------+----------+------------------+ 3 rows in set ``` 默认情况下，事件调度程序线程未启用。 要启用和启动事件调度程序线程，需要执行以下命令： ```sql SET GLOBAL event_scheduler = ON; ``` 现在看到事件调度器线程的状态，再次执行`SHOW PROCESSLIST`命令，结果如下所示 - ```sql mysql> SHOW PROCESSLIST; +----+-----------------+-----------------+----------+---------+------+------------------------+------------------+ | Id | User | Host | db | Command | Time | State | Info | +----+-----------------+-----------------+----------+---------+------+------------------------+------------------+ | 2 | root | localhost:50405 | NULL | Sleep | 1986 | | NULL | | 3 | root | localhost:50406 | yiibaidb | Sleep | 1984 | | NULL | | 4 | root | localhost:50407 | yiibaidb | Query | 0 | starting | SHOW PROCESSLIST | | 5 | event_scheduler | localhost | NULL | Daemon | 6 | Waiting on empty queue | NULL | +----+-----------------+-----------------+----------+---------+------+------------------------+------------------+ 4 rows in set ``` 要禁用并停止事件调度程序线程，可通过执行`SET GLOBAL`命令将`event_scheduler`其值设置为`OFF`： ```sql SET GLOBAL event_scheduler = OFF; ``` ## 创建新的MySQL事件 创建事件与创建其他数据库对象(如存储过程或触发器)类似。事件是一个包含SQL语句的命名对象。 [存储过程](http://www.yiibai.com/mysql/stored-procedure.html)仅在直接调用时执行; [触发器](http://www.yiibai.com/mysql/triggers.html)则与一个表相关联的事件(例如[插入](http://www.yiibai.com/mysql/insert-statement.html)，[更新](http://www.yiibai.com/mysql/update-data.html)或[删除](http://www.yiibai.com/mysql/delete-statement.html))事件发生时，可以在一次或更多的规则间隔执行事件时执行触发。 要创建和计划新事件，请使用`CREATE EVENT`语句，如下所示： ```sql CREATE EVENT [IF NOT EXIST] event_name ON SCHEDULE schedule DO event_body ``` 下面让我们更详细地解释语法中的一些参数 - * *首先*，在`CREATE EVENT`子句之后指定事件名称。事件名称在数据库模式中必须是唯一的。 * *其次*，在`ON SCHEDULE`子句后面加上一个表。如果事件是一次性事件，则使用语法：`AT timestamp [+ INTERVAL]`，如果事件是循环事件，则使用`EVERY`子句：`EVERY interval STARTS timestamp [+INTERVAL] ENDS timestamp [+INTERVAL]` * *第三*，将`DO`语句放在`DO`关键字之后。请注意，可以在事件主体内调用存储过程。 如果您有复合SQL语句，可以将它们放在`BEGIN END`块中。 我们来看几个创建事件的例子来了解上面的语法。 *首先*，创建并计划将一个消息插入到`messages`表中的一次性事件，请执行以下步骤： ```sql USE testdb; CREATE TABLE IF NOT EXISTS messages ( id INT PRIMARY KEY AUTO_INCREMENT, message VARCHAR(255) NOT NULL, created_at DATETIME NOT NULL ); ``` *其次*，使用`CREATE EVENT`语句创建一个事件： ```sql CREATE EVENT IF NOT EXISTS test_event_01 ON SCHEDULE AT CURRENT_TIMESTAMP DO INSERT INTO messages(message,created_at) VALUES('Test MySQL Event 1',NOW()); ``` *第三*，检查`messages`表; 会看到有`1`条记录。这意味着事件在创建时被执行。 ```sql SELECT * FROM messages; ``` 执行上面查询语句，得到以下结果 - ```sql mysql> SELECT * FROM messages; +----+--------------------+---------------------+ | id | message | created_at | +----+--------------------+---------------------+ | 1 | Test MySQL Event 1 | 2017-08-03 04:23:11 | +----+--------------------+---------------------+ 1 row in set ``` 要显示数据库(`testdb`)的所有事件，请使用以下语句： ```sql SHOW EVENTS FROM testdb; ``` 执行上面查询看不到任何行返回，因为事件在到期时自动删除。 在我们的示例中，它是一次性的事件，在执行完成时就过期了。 要更改此行为，可以使用`ON COMPLETION PRESERVE`子句。以下语句创建另一个一次性事件，在其创建时间`1`分钟后执行，执行后不会被删除。 ```sql CREATE EVENT test_event_02 ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 1 MINUTE ON COMPLETION PRESERVE DO INSERT INTO messages(message,created_at) VALUES('Test MySQL Event 2',NOW()); ``` 等待`1`分钟后，查看`messages`表，添加了另一条记录： ```sql SELECT * FROM messages; ``` 执行上面查询语句，得到以下结果 - ```sql mysql> SELECT * FROM messages; +----+--------------------+---------------------+ | id | message | created_at | +----+--------------------+---------------------+ | 1 | Test MySQL Event 1 | 2017-08-03 04:23:11 | | 2 | Test MySQL Event 2 | 2017-08-03 04:24:48 | +----+--------------------+---------------------+ 2 rows in set ``` 如果再次执行`SHOW EVENTS`语句，看到事件是由于`ON COMPLETION PRESERVE`子句的影响： ```sql SHOW EVENTS FROM testdb; ``` 执行上面查询语句，得到以下结果 - ```sql mysql> SHOW EVENTS FROM testdb; +--------+---------------+----------------+-----------+----------+---------------------+----------------+----------------+--------+------+----------+------------+----------------------+----------------------+--------------------+ | Db | Name | Definer | Time zone | Type | Execute at | Interval value | Interval field | Starts | Ends | Status | Originator | character_set_client | collation_connection | Database Collation | +--------+---------------+----------------+-----------+----------+---------------------+----------------+----------------+--------+------+----------+------------+----------------------+----------------------+--------------------+ | testdb | test_event_02 | root@localhost | SYSTEM | ONE TIME | 2017-08-03 04:24:48 | NULL | NULL | NULL | NULL | DISABLED | 0 | utf8 | utf8_general_ci | utf8_general_ci | +--------+---------------+----------------+-----------+----------+---------------------+----------------+----------------+--------+------+----------+------------+----------------------+----------------------+--------------------+ 1 row in set ``` 以下语句创建一个循环的事件，每分钟执行一次，并在其创建时间的`1`小时内过期： ```sql CREATE EVENT test_event_03 ON SCHEDULE EVERY 1 MINUTE STARTS CURRENT_TIMESTAMP ENDS CURRENT_TIMESTAMP + INTERVAL 1 HOUR DO INSERT INTO messages(message,created_at) VALUES('Test MySQL recurring Event',NOW()); ``` 请注意，使用`STARTS`和`ENDS`子句定义事件的有效期。等待个3，5分钟后再查看`messages`表数据，以测试验证此循环事件的执行。 ```sql SELECT * FROM messages; ``` 执行上面查询语句，得到以下结果 - ```sql mysql> SELECT * FROM messages; +----+----------------------------+---------------------+ | id | message | created_at | +----+----------------------------+---------------------+ | 1 | Test MySQL Event 1 | 2017-08-03 04:23:11 | | 2 | Test MySQL Event 2 | 2017-08-03 04:24:48 | | 3 | Test MySQL recurring Event | 2017-08-03 04:25:20 | | 4 | Test MySQL recurring Event | 2017-08-03 04:26:20 | | 5 | Test MySQL recurring Event | 2017-08-03 04:27:20 | +----+----------------------------+---------------------+ 5 rows in set ``` ## 删除MySQL事件 要删除现有事件，请使用`DROP EVENT`语句，如下所示： ```sql DROP EVENT [IF EXISTS] event_name; ``` 例如，要删除`test_event_03`的事件，请使用以下语句： ```sql DROP EVENT IF EXISTS test_event_03; ``` 在本教程中，您已经了解了MySQL事件，如何从数据库模式创建和删除事件。 在下一个教程中，我们将向您展示如何修改事件。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://hezhiqiang-book.gitbook.io/mysql/di-si-zhang/ji-hua-shi-jian.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.