文档主页
MySQL 9.0 参考手册
相关文档 下载本手册

MySQL 9.0 参考手册  /  ...  /  INFORMATION_SCHEMA EVENTS 表

28.3.14 INFORMATION_SCHEMA EVENTS 表

EVENTS 表提供有关事件管理器事件的信息,这些信息在 第 27.5 节“使用事件调度程序” 中讨论。

EVENTS 表包含以下列

  • EVENT_CATALOG

    事件所属目录的名称。此值始终为 def

  • EVENT_SCHEMA

    事件所属模式(数据库)的名称。

  • EVENT_NAME

    事件的名称。

  • DEFINER

    DEFINER 子句中命名的帐户(通常是创建事件的用户),格式为 '用户名'@'主机名''

  • TIME_ZONE

    事件时区,用于调度事件并在事件执行期间生效。默认值为 SYSTEM

  • EVENT_BODY

    事件的 DO 子句中语句使用的语言。该值始终为 SQL

  • EVENT_DEFINITION

    构成事件的 DO 子句的 SQL 语句的文本;换句话说,就是此事件执行的语句。

  • EVENT_TYPE

    事件重复类型,ONE TIME(瞬态)或 RECURRING(重复)。

  • EXECUTE_AT

    对于一次性事件,这是在用于创建事件的 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

  • INTERVAL_VALUE

    对于重复事件,两次事件执行之间要等待的间隔数。对于瞬态事件,该值始终为 NULL

  • INTERVAL_FIELD

    重复事件在重复之前等待的时间单位。对于瞬态事件,该值始终为 NULL

  • SQL_MODE

    创建或更改事件时生效的 SQL 模式,以及事件在该模式下执行。有关允许的值,请参阅 第 7.1.11 节“服务器 SQL 模式”

  • STARTS

    重复事件的开始日期和时间。这将显示为 DATETIME 值,如果未为事件定义开始日期和时间,则为 NULL。对于瞬态事件,此列始终为 NULL。对于定义中包含 STARTS 子句的重复事件,此列包含相应的 DATETIME 值。与 EXECUTE_AT 列一样,此值会解析使用的任何表达式。如果没有影响事件时间的 STARTS 子句,则此列为 NULL

  • ENDS

    对于定义中包含 ENDS 子句的重复事件,此列包含相应的 DATETIME 值。与 EXECUTE_AT 列一样,此值会解析使用的任何表达式。如果没有影响事件时间的 ENDS 子句,则此列为 NULL

  • STATUS

    事件状态。可以是 ENABLEDDISABLEDREPLICA_SIDE_DISABLED(在 MySQL 8.2.0 之前,此值为 SLAVESIDE_DISABLED,现已弃用)。REPLICA_SIDE_DISABLED 表示事件的创建发生在另一个充当复制源的 MySQL 服务器上,并复制到当前充当副本的 MySQL 服务器,但该事件目前未在副本上执行。有关更多信息,请参阅 第 19.5.1.16 节“已调用功能的复制”

  • ON_COMPLETION

    两个值之一:PRESERVENOT PRESERVE

  • CREATED

    创建事件的日期和时间。这是一个 TIMESTAMP 值。

  • LAST_ALTERED

    上次修改事件的日期和时间。这是一个 TIMESTAMP 值。如果事件自创建以来未被修改,则此值与 CREATED 值相同。

  • LAST_EXECUTED

    事件上次执行的日期和时间。这是一个 DATETIME 值。如果事件从未执行,则此列为 NULL

    LAST_EXECUTED 指示事件开始的时间。因此,ENDS 列的值永远不会小于 LAST_EXECUTED

  • EVENT_COMMENT

    注释的文本(如果事件有注释)。如果没有,则此值为 NULL。

  • ORIGINATOR

    创建事件的 MySQL 服务器的服务器 ID;用于复制。如果在复制源上执行,则可以通过 ALTER EVENT 将此值更新为发生该语句的服务器的服务器 ID。默认值为 0。

  • CHARACTER_SET_CLIENT

    创建事件时 character_set_client 系统变量的会话值。

  • COLLATION_CONNECTION

    创建事件时 collation_connection 系统变量的会话值。

  • DATABASE_COLLATION

    与事件关联的数据库的排序规则。

备注

示例

假设用户 'jon'@'ghidora' 创建了一个名为 e_daily 的事件,然后在几分钟后使用 ALTER EVENT 语句对其进行了修改,如下所示

DELIMITER |

CREATE EVENT e_daily
    ON SCHEDULE
      EVERY 1 DAY
    COMMENT 'Saves total number of sessions then clears the table each day'
    DO
      BEGIN
        INSERT INTO site_activity.totals (time, total)
          SELECT CURRENT_TIMESTAMP, COUNT(*)
            FROM site_activity.sessions;
        DELETE FROM site_activity.sessions;
      END |

DELIMITER ;

ALTER EVENT e_daily
    ENABLE;

(请注意,注释可以跨越多行。)

然后,该用户可以运行以下 SELECT 语句,并获取显示的输出

mysql> SELECT * FROM INFORMATION_SCHEMA.EVENTS
       WHERE EVENT_NAME = 'e_daily'
       AND EVENT_SCHEMA = 'myschema'\G
*************************** 1. row ***************************
       EVENT_CATALOG: def
        EVENT_SCHEMA: myschema
          EVENT_NAME: e_daily
             DEFINER: jon@ghidora
           TIME_ZONE: SYSTEM
          EVENT_BODY: SQL
    EVENT_DEFINITION: BEGIN
        INSERT INTO site_activity.totals (time, total)
          SELECT CURRENT_TIMESTAMP, COUNT(*)
            FROM site_activity.sessions;
        DELETE FROM site_activity.sessions;
      END
          EVENT_TYPE: RECURRING
          EXECUTE_AT: NULL
      INTERVAL_VALUE: 1
      INTERVAL_FIELD: DAY
            SQL_MODE: ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,
                      NO_ZERO_IN_DATE,NO_ZERO_DATE,
                      ERROR_FOR_DIVISION_BY_ZERO,
                      NO_ENGINE_SUBSTITUTION
              STARTS: 2018-08-08 11:06:34
                ENDS: NULL
              STATUS: ENABLED
       ON_COMPLETION: NOT PRESERVE
             CREATED: 2018-08-08 11:06:34
        LAST_ALTERED: 2018-08-08 11:06:34
       LAST_EXECUTED: 2018-08-08 16:06:34
       EVENT_COMMENT: Saves total number of sessions then clears the
                      table each day
          ORIGINATOR: 1
CHARACTER_SET_CLIENT: utf8mb4
COLLATION_CONNECTION: utf8mb4_0900_ai_ci
  DATABASE_COLLATION: utf8mb4_0900_ai_ci

事件信息也可以从 SHOW EVENTS 语句中获取。请参阅 第 15.7.7.19 节“SHOW EVENTS 语句”。以下语句是等效的

SELECT
    EVENT_SCHEMA, EVENT_NAME, DEFINER, TIME_ZONE, EVENT_TYPE, EXECUTE_AT,
    INTERVAL_VALUE, INTERVAL_FIELD, STARTS, ENDS, STATUS, ORIGINATOR,
    CHARACTER_SET_CLIENT, COLLATION_CONNECTION, DATABASE_COLLATION
  FROM INFORMATION_SCHEMA.EVENTS
  WHERE table_schema = 'db_name'
  [AND column_name LIKE 'wild']

SHOW EVENTS
  [FROM db_name]
  [LIKE 'wild']