MySQL :: MySQL 8.4 参考手册 :: 15.7.7.19 SHOW EVENTS 语句

版本 8.4

8.0 日语

MySQL 8.4 参考手册 / ... / SHOW EVENTS 语句

15.7.7.19 SHOW EVENTS 语句

SHOW EVENTS
    [{FROM | IN} schema_name]
    [LIKE 'pattern' | WHERE expr]

此语句显示有关事件管理器事件的信息，这些事件在第 27.4 节“使用事件调度程序” 中讨论。它需要对要显示事件的数据库具有 EVENT 权限。

SHOW EVENTS 以其最简单的形式列出当前模式中的所有事件

mysql> SELECT CURRENT_USER(), SCHEMA();
+----------------+----------+
| CURRENT_USER() | SCHEMA() |
+----------------+----------+
| jon@ghidora    | myschema |
+----------------+----------+
1 row in set (0.00 sec)

mysql> SHOW EVENTS\G
*************************** 1. row ***************************
                  Db: myschema
                Name: e_daily
             Definer: jon@ghidora
           Time zone: SYSTEM
                Type: RECURRING
          Execute at: NULL
      Interval value: 1
      Interval field: DAY
              Starts: 2018-08-08 11:06:34
                Ends: NULL
              Status: ENABLED
          Originator: 1
character_set_client: utf8mb4
collation_connection: utf8mb4_0900_ai_ci
  Database Collation: utf8mb4_0900_ai_ci

要查看特定模式的事件，请使用 FROM 子句。例如，要查看 test 模式的事件，请使用以下语句

SHOW EVENTS FROM test;

LIKE 子句（如果存在）指示要匹配的事件名称。WHERE 子句可用于使用更一般的条件选择行，如第 28.8 节“SHOW 语句的扩展” 中所述。

SHOW EVENTS 输出包含以下列

数据库
事件所属模式（数据库）的名称。
名称
事件的名称。
定义者
创建事件的用户的帐户，格式为 'user_name'@'host_name'。
时区
事件时区，它是用于安排事件并在事件执行时生效的时区。默认值为 SYSTEM。
类型
事件重复类型，可以是 ONE TIME（一次性）或 RECURRING（重复）。
执行时间
对于一次性事件，这是在用于创建事件的 CREATE EVENT 语句或最后一个修改事件的 ALTER EVENT 语句的 AT 子句中指定的 DATETIME 值。此列中显示的值反映了事件 AT 子句中包含的任何 INTERVAL 值的加减。例如，如果使用 ON SCHEDULE AT CURRENT_TIMESTAMP + '1:6' DAY_HOUR 创建了一个事件，并且该事件是在 2018-02-09 14:05:30 创建的，则此列中显示的值将是 '2018-02-10 20:05:30'。如果事件的时间安排由 EVERY 子句而不是 AT 子句确定（也就是说，如果事件是重复的），则此列的值为 NULL。
间隔值
对于重复事件，两次事件执行之间要等待的间隔数。对于一次性事件，此列的值始终为 NULL。
间隔字段
用于重复事件在重复之前等待的间隔的时间单位。对于一次性事件，此列的值始终为 NULL。
开始时间
重复事件的开始日期和时间。这将显示为 DATETIME 值，如果未为此事件定义开始日期和时间，则为 NULL。对于一次性事件，此列始终为 NULL。对于定义中包含 STARTS 子句的重复事件，此列包含相应的 DATETIME 值。与 Execute At 列一样，此值会解析使用的任何表达式。如果没有影响事件时间安排的 STARTS 子句，则此列为 NULL。
结束时间
对于定义中包含 ENDS 子句的重复事件，此列包含相应的 DATETIME 值。与 Execute At 列一样，此值会解析使用的任何表达式。如果没有影响事件时间安排的 ENDS 子句，则此列为 NULL。
状态
事件状态。可以是 ENABLED、DISABLED 或 REPLICA_SIDE_DISABLED。 REPLICA_SIDE_DISABLED 表示事件的创建发生在另一个充当复制源的 MySQL 服务器上，并复制到当前充当副本的 MySQL 服务器，但该事件目前未在副本上执行。有关更多信息，请参阅第 19.5.1.16 节“复制调用的功能”。
REPLICA_SIDE_DISABLED 替换了 SLAVESIDE_DISABLED，后者现已弃用，并将在未来版本的 MySQL 中删除。
创建者
创建事件的 MySQL 服务器的服务器 ID；用于复制。如果在源服务器上执行，则可以通过 ALTER EVENT 将此值更新为该语句发生所在的服务器的服务器 ID。默认值为 0。
character_set_client
创建事件时 character_set_client 系统变量的会话值。
collation_connection
创建事件时 collation_connection 系统变量的会话值。
数据库排序规则
与事件关联的数据库的排序规则。

有关 REPLICA_SIDE_DISABLED 和 Originator 列的更多信息，请参阅第 19.5.1.16 节“复制调用的功能”。

SHOW EVENTS 显示的时间以事件时区给出，如第 27.4.4 节“事件元数据” 中所述。

事件信息也可以从 INFORMATION_SCHEMA EVENTS 表中获取。请参阅第 28.3.14 节“INFORMATION_SCHEMA EVENTS 表”。

事件操作语句未在 SHOW EVENTS 的输出中显示。请使用 SHOW CREATE EVENT 或 INFORMATION_SCHEMA EVENTS 表。