23.4.2 Event Scheduler Configuration — MySQL 5.7

23.4.2 Настройка планировщика событий

События выполняются специальной потоком планировщика событий; когда мы говорим о планировщике событий, мы на самом деле имеем в виду этот поток. При работе поток планировщика событий и его текущее состояние могут быть видны пользователям, имеющим привилегию PROCESS, в выводе SHOW PROCESSLIST, как показано в последующем обсуждении.

Глобальная системная переменная event_scheduler определяет, включен ли планировщик событий и запущен ли он на сервере. Она имеет одно из следующих значений, которые влияют на планирование событий, как описано:

OFF: Планировщик событий остановлен. Поток планировщика событий не работает, не отображается в выводе SHOW PROCESSLIST, и запланированные события не выполняются. OFF — значение по умолчанию для event_scheduler.

Когда планировщик событий остановлен (event_scheduler равно OFF), его можно запустить, установив значение event_scheduler в ON. (См. следующий пункт.)
ON: Планировщик событий запущен; поток планировщика событий работает и выполняет все запланированные события.

Когда планировщик событий ON, поток планировщика событий отображается в выводе SHOW PROCESSLIST как процесс-демон, а его состояние представлено так:
```
mysql> SHOW PROCESSLIST\G
*************************** 1. row ***************************
     Id: 1
   User: root
   Host: localhost
     db: NULL
Command: Query
   Time: 0
  State: NULL
   Info: show processlist
*************************** 2. row ***************************
     Id: 2
   User: event_scheduler
   Host: localhost
     db: NULL
Command: Daemon
   Time: 3
  State: Waiting for next activation
   Info: NULL
2 rows in set (0.00 sec)
```
Планирование событий можно остановить, установив значение event_scheduler в OFF.
DISABLED: Это значение делает планировщик событий неработоспособным. Когда планировщик событий DISABLED, поток планировщика событий не работает (и, следовательно, не отображается в выводе SHOW PROCESSLIST). Кроме того, состояние планировщика событий не может быть изменено во время выполнения.

Если статус планировщика событий не установлен в DISABLED, event_scheduler можно переключать между значениями ON и OFF (используя SET). Также можно использовать 0 для OFF и 1 для ON при установке этой переменной. Таким образом, любое из следующих 4 утверждений можно использовать в клиенте mysql для включения планировщика событий:

SET GLOBAL event_scheduler = ON;
SET @@GLOBAL.event_scheduler = ON;
SET GLOBAL event_scheduler = 1;
SET @@GLOBAL.event_scheduler = 1;

Аналогично, любое из этих 4 утверждений можно использовать для выключения планировщика событий:

SET GLOBAL event_scheduler = OFF;
SET @@GLOBAL.event_scheduler = OFF;
SET GLOBAL event_scheduler = 0;
SET @@GLOBAL.event_scheduler = 0;

Хотя ON и OFF имеют числовые эквиваленты, значение, отображаемое для event_scheduler функциями SELECT или SHOW VARIABLES, всегда является одним из OFF, ON или DISABLED. DISABLED не имеет числового эквивалента. По этой причине ON и OFF обычно предпочтительнее 1 и 0 при установке этой переменной.

Обратите внимание, что попытка установить event_scheduler без указания его как глобальной переменной приводит к ошибке:

mysql< SET @@event_scheduler = OFF;
ERROR 1229 (HY000): Variable 'event_scheduler' is a GLOBAL
variable and should be set with SET GLOBAL

Важно

Планировщик событий можно установить в DISABLED только при запуске сервера. Если event_scheduler равно ON или OFF, вы не можете установить его в DISABLED во время выполнения. Также, если планировщик событий установлен в DISABLED при запуске, вы не можете изменить значение event_scheduler во время выполнения.

Чтобы отключить планировщик событий, воспользуйтесь одним из двух следующих методов:

В качестве параметра командной строки при запуске сервера:
```
--event-scheduler=DISABLED
```
В файле конфигурации сервера (my.cnf или my.ini на системах Windows), добавьте строку, которую сервер может прочитать (например, в разделе [mysqld]):
```
event_scheduler=DISABLED
```

Чтобы включить планировщик событий, перезапустите сервер без параметра командной строки --event-scheduler=DISABLED или после удаления или комментирования строки, содержащей event-scheduler=DISABLED в файле конфигурации сервера, как это необходимо. В качестве альтернативы, можно использовать ON (или 1) или OFF (или 0) вместо значения DISABLED при запуске сервера.

Примечание

Вы можете выполнять операторы управления событиями, когда event_scheduler установлено в DISABLED. В таких случаях не генерируются никакие предупреждения или ошибки (при условии, что сами операторы допустимы). Однако запланированные события не могут выполняться, пока эта переменная не будет установлена в ON (или 1). После этого поток планировщика событий выполняет все события, условия планирования которых выполнены.

Запуск сервера MySQL с параметром --skip-grant-tables приводит к установке event_scheduler в DISABLED, что переопределяет любое другое значение, заданное в командной строке или в файлах my.cnf или my.ini (Ошибка #26807).

SQL-операторы, используемые для создания, изменения и удаления событий, см. в разделе 23.4.3 «Синтаксис событий».

MySQL предоставляет таблицу EVENTS в базе данных INFORMATION_SCHEMA. Эту таблицу можно запросить, чтобы получить информацию о запланированных событиях, которые были определены на сервере. Дополнительную информацию см. в разделе 23.4.4 «Метаданные событий» и разделе 24.3.8 «Таблица INFORMATION_SCHEMA EVENTS».

Сведения о планировании событий и системе привилегий MySQL см. в разделе 23.4.6 «Планировщик событий и привилегии MySQL».