【MySQL 8.0 手册： SQL语句语法：数据定义语句】CREATE EVENT 语法

13.1.12 创建事件语法 （CREATE EVENT Syntax）

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 'string']
    [DO event_body]

---

• 此声明创建并安排新的事件。除非事件计划程序已启用，否则该事件将不会运行。

• CREATE EVENT需要 EVENT 特权才能创建事件的模式。可能还需要 SET_USER_ID或 SUPER特权，具体取决于 DEFINER 值

---

有效CREATE EVENT声明的最低要求如下：
- 关键字CREATE EVENT加上一个事件名称，它唯一标识数据库模式中的事件。
- 一个ON SCHEDULE子句，用于确定事件执行的时间和频率。
- 一个DO子句，其中包含要由事件执行的SQL语句。

最小 CREATE EVENT 声明示例：

CREATE EVENT myevent
    ON SCHEDULE AT CURRENT_TIMESTAMP + INTERVAL 1 HOUR
    DO
      UPDATE myschema.mytable SET mycol = mycol + 1;

示例说明：

1. 创建一个名为myevent的事件 。事件在创建后执行一次 ：通过运行将 myschema.mytable 表格的 mycol 列的值递增 1 的 SQL 语句。
2. event_name必须是有效的 MySQL 标识符，最大长度为64个字符。
3. 事件名称是不区分大小写。所以不能有两个名为 myevent 和 MyEvent 的事件。
4. 通常，管理事件名称的规则与存储例程的名称相同。

一个事件与一个模式相关联。
如果没有模式被指定为event_name的一部分，则假定默认（当前）模式。
要在特定模式中创建事件，请使用schema_name.event_name语法使用模式限定事件名称。

---

解释：

CREATE
    [DEFINER = { user | CURRENT_USER }]
    EVENT

DEFINER子句指定在事件执行时检查访问特权时要使用的MySQL帐户。
如果给出用户值，它应该是指定为'user_name'@'host_name'，CURRENT_USER或CURRENT_USER（）的MySQL帐户。
DEFINER的默认值是执行CREATE EVENT语句的用户。 这与明确指定DEFINER = CURRENT_USER相同。

如果指定了DEFINER子句，则这些规则将确定有效的DEFINER用户值：

• 如果您没有SET_USER_ID或SUPER权限，则唯一允许的用户值是您自己的帐户，可以按字面或使用CURRENT_USER指定。 您无法将定义者设置为某个其他帐户。

• 如果您具有SET_USER_ID或SUPER权限，则可以指定任何语法上有效的帐户名称。 如果该帐户不存在，则会生成警告。

• 尽管可以使用不存在的DEFINER帐户创建事件，但如果该帐户不存在，则会在事件执行时发生错误。

在事件中，CURRENT_USER（）函数返回用于在事件执行时检查权限的帐户，该帐户是DEFINER用户。

---

解释：

[IF NOT EXISTS]
    event_name

IF NOT EXISTS对于CREATE EVENT具有与CREATE TABLE相同的含义：如果名称为event_name的事件已存在于同一模式中，则不采取任何操作，并且不会产生错误。 （但是，在这种情况下会产生警告。）

---

解释：

ON SCHEDULE schedule

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}

ON SCHEDULE子句确定event_body为事件定义的 时间， 频率 和 时长 。
本条款采取两种形式之一：

• AT timestamp用于一次性事件。
  它指定事件只在指定的日期和时间执行一次 timestamp，其中必须包含日期和时间，或者必须是解析为日期时间值的表达式。
  您可以为此使用DATETIME或者 TIMESTAMP类型的值 。
  如果日期过去，则会发生警告，如下所示：

  mysql> SELECT NOW();
  +---------------------+
  | NOW()               |
  +---------------------+
  | 2006-02-10 23:59:01 |
  +---------------------+
  1 row in set (0.04 sec)
  
  mysql> CREATE EVENT e_totals
      ->     ON SCHEDULE AT '2006-02-10 23:59:00'
      ->     DO INSERT INTO test.totals VALUES (NOW());
  Query OK, 0 rows affected, 1 warning (0.00 sec)
  
  mysql> SHOW WARNINGS\G
  *************************** 1. row ***************************
    Level: Note
     Code: 1588
  Message: Event execution time is in the past and ON COMPLETION NOT
           PRESERVE is set. The event was dropped immediately after
           creation.

  CREATE EVENT 本身无效的语句 - 无论出于何种原因 - 都会因错误而失败。

  使用CURRENT_TIMESTAMP 指定当前的日期和时间。
  在这种情况下，事件一旦创建就会发挥作用。

  要创建相对于当前日期和时间在将来某个时间点发生的事件 - 例如用“ 从现在开始三周 ”表达的事件 - 可以使用可选的子句。
  该 部分由数量和时间单位两部分组成，并遵循相同的语法规则来管理函数中使用的时间间隔 。
  单位关键字也是 除了在定义一个事件时不能使用任何涉及微秒的单位，对于一些间隔类型，可以使用复杂的时间单位，例如，“2分钟和10秒”可以表示为+ INTERVAL '2:10' MINUTE_SECOND。

  合并间隔。
  例如，AT CURRENT_TIMESTAMP + INTERVAL 3 WEEK INTERVAL 2 DAY相当于“从现在开始的三周和两天”。 这种条款的每一部分必须以+ INTERVAL开头。

• EVERY子句：定期重复操作。
  EVERY关键字后跟一个interval，如前面关于AT关键字的讨论中所述。 （+ INTERVAL并不适用于每件事。）例如，EVERY 6 WEEK是指“ 每六周 ”

  虽然在EVERY子句中不允许使用+ INTERVAL子句，但可以使用+ INTERVAL中允许的相同复杂时间单位。

  EVERY子句可以包含一个可选的STARTS子句。

  STARTS后跟一个时间戳值，指示何时应该开始重复动作，还可以使用+ INTERVAL间隔来指定“从现在开始”的时间量。
  例如，EVERY 3 MONTH STARTS CURRENT_TIMESTAMP + INTERVAL 1 WEEK 意味着“每三个月，从现在起一周开始”。
  同样，EVERY 2 WEEK STARTS CURRENT_TIMESTAMP + INTERVAL '6:15' HOUR_MINUTE意味着 “每两周，从现在开始6个小时15分钟”。
  不指定STARTS与使用STARTS CURRENT_TIMESTAMP相同 - 即为事件指定的操作在创建事件时立即开始重复。
  不指定STARTS与使用STARTS CURRENT_TIMESTAMP相同 - 即为事件指定的操作在创建事件时立即开始重复。

  EVERY子句可以包含一个可选的ENDS子句。

  ENDS关键字后跟一个时间戳值，告诉MySQL事件应该何时停止重复。
  您也可以在ENDS中使用+ INTERVAL间隔;
  例如“EVERY 12 HOUR STARTS CURRENT_TIMESTAMP + INTERVAL 30 MINUTE ENDS CURRENT_TIMESTAMP + INTERVAL 4 WEEK”相当于 “每12小时，从现在开始三十分钟开始，从现在开始四周结束”。
  不使用ENDS意味着事件无限期地继续执行。

  ENDS支持与STARTS一样的复杂时间单位的语法。

  在EVERY子句中可以使用STARTS，ENDS，或者都不使用。

  如果重复事件不在其调度间隔内终止，则结果可能是同时执行的事件的多个实例。 如果这是不可取的，你应该建立一个机制来防止同时发生的事件。
  例如，您可以使用GET_LOCK（）函数或行或表锁定。

ON SCHEDULE子句可以使用涉及内置MySQL函数和用户变量的表达式来获取它包含的任何时间戳记或间隔值。
您不得在这些表达式中使用存储的函数或用户定义的函数，也不得使用任何表引用; 但是，您可以使用SELECT FROM DUAL。 对于CREATE EVENT和ALTER EVENT语句都是如此。
在这种情况下，对存储的函数，用户定义的函数和表的引用是不允许的，并且会因错误而失败。

ON SCHEDULE子句中的时间使用当前会话的time_zone值进行解释。
这成为事件时区; 即用于事件调度的时区，并在执行时在事件内生效。
这些时间转换为UTC并与mysql.event表中的事件时区一起存储。
这可以使事件执行按照定义继续进行，而不管后续对服务器时区或夏令时效果所做的任何更改。

---

解释

 [ON COMPLETION [NOT] PRESERVE]

通常，一旦事件已经过期，它会立即被删除。
您可以通过指定ON COMPLETION PRESERVE来覆盖此行为。
使用ON COMPLETION NOT PRESERVE只会使默认的非持久行为显式化。

---

解释

 [ENABLE | DISABLE | DISABLE ON SLAVE]

使用DISABLE关键字阻止事件为活动状态。
使用ENABLE关键字开启事件为活动状态。
DISABLE ON SLAVE被设置为复制从站上事件的状态，以指示事件在主站上创建并复制到从站，但不在从站上执行。

---

解释

[COMMENT 'string']

使用COMMENT子句为事件提供注释。
注释最多为64个字符。 注释文本是一个字符串文字，必须用引号括起来。

---

解释

DO event_body;

DO子句指定事件执行的动作，并由SQL语句组成。
几乎任何可以在存储例程中使用的有效MySQL语句也可以用作预定事件的操作语句。
例如，以下事件每小时从会话表中删除所有行，其中此表是site_activity模式的一部分：

CREATE EVENT e_hourly
    ON SCHEDULE
      EVERY 1 HOUR
    COMMENT 'Clears out sessions table each hour.'
    DO
      DELETE FROM site_activity.sessions;

当事件被创建或更改时，MySQL存储sql_mode系统变量设置，并始终使用此设置执行该事件，而不管当事件开始执行时的当前服务器SQL模式如何。

在其DO子句中包含ALTER EVENT语句的CREATE EVENT语句似乎成功;
但是，当服务器尝试执行结果的预定事件时，执行失败并出现错误。