28.3.14 The INFORMATION_SCHEMA EVENTS Table — MySQL 9.2

28.3.14 Таблица INFORMATION_SCHEMA EVENTS

Таблица EVENTS предоставляет информацию о событиях Event Manager, которые обсуждаются в разделе 27.5, «Использование планировщика событий».

В таблице EVENTS есть следующие столбцы:

EVENT_CATALOG

Имя каталога, которому принадлежит событие. Это значение всегда def.
EVENT_SCHEMA

Имя схемы (базы данных), к которой относится событие.
EVENT_NAME

Имя события.
DEFINER

Имя пользователя, указанное в предложении DEFINER (часто пользователь, создавший событие), в формате 'user_name'@'host_name'.
TIME_ZONE

Временная зона события, которая используется для планирования события и действует во время его выполнения. Значение по умолчанию — SYSTEM.
EVENT_BODY

Язык, используемый для инструкций в предложении DO события. Значение всегда SQL.
EVENT_DEFINITION

Текст SQL-инструкции, составляющей предложение DO события; другими словами, инструкция, выполняемая этим событием.
EVENT_TYPE

Тип повторения события: ONE TIME (однократное) или RECURRING (повторяющееся).
EXECUTE_AT

Для однократного события это значение DATETIME, указанное в предложении AT инструкции CREATE EVENT по созданию события или последней инструкции ALTER EVENT, которая изменяла событие. Показывает добавленное или вычтенное значение INTERVAL, включенное в предложение AT события. Например, если событие создано с помощью 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

Статус события. Одно из значений: ENABLED, DISABLED или REPLICA_SIDE_DISABLED (до MySQL 8.2.0 это было SLAVESIDE_DISABLED, теперь устарело). REPLICA_SIDE_DISABLED указывает, что создание события произошло на другом сервере MySQL, работающем как источник репликации, и было реплицировано на текущий сервер MySQL, работающий как реплика, но в настоящее время событие не выполняется на реплике. Дополнительную информацию см. в разделе 19.5.1.16, «Репликация вызываемых функций».
ON_COMPLETION

Одно из двух значений: PRESERVE или NOT PRESERVE.
CREATED

Дата и время создания события. Это значение TIMESTAMP.
LAST_ALTERED

Дата и время последнего изменения события. Это значение TIMESTAMP. Если событие не изменялось с момента создания, это значение такое же, как и у CREATED.
LAST_EXECUTED

Дата и время последнего выполнения события. Это значение DATETIME. Если событие никогда не выполнялось, этот столбец равен NULL.

LAST_EXECUTED указывает, когда событие началось. В результате столбец ENDS никогда не меньше LAST_EXECUTED.
EVENT_COMMENT

Текст комментария, если событие имеет комментарий. В противном случае значение пустое.
ORIGINATOR

Идентификатор сервера MySQL, на котором было создано событие; используется в репликации. Это значение может быть обновлено инструкцией ALTER EVENT до идентификатора сервера, на котором выполняется эта инструкция, если она выполняется на реплицирующем сервере. Значение по умолчанию — 0.
CHARACTER_SET_CLIENT

Значение сессии системной переменной character_set_client при создании события.
COLLATION_CONNECTION

Значение сессии системной переменной collation_connection при создании события.
DATABASE_COLLATION

Коллизия базы данных, с которой связано событие.

Примечания

EVENTS — это нестандартная таблица INFORMATION_SCHEMA.
Время в таблице EVENTS отображается с использованием временной зоны события, текущей временной зоны сессии или UTC, как описано в разделе 27.5.4, «Метаданные события».
Дополнительную информацию о REPLICA_SIDE_DISABLED и столбце ORIGINATOR см. в разделе 19.5.1.16, «Репликация вызываемых функций».

Пример

Предположим, пользователь '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.20, «Инструкция 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']