15.7.8.7 RESET PERSIST Statement — MySQL 9.2

15.7.8.7 Выполнение команды RESET PERSIST

RESET PERSIST [[IF EXISTS] system_var_name]

RESET PERSIST удаляет сохранённые настройки глобальных системных переменных из файла опций mysqld-auto.cnf в каталоге данных. Удаление сохранённой системной переменной приводит к тому, что переменная больше не будет инициализироваться из mysqld-auto.cnf при запуске сервера. Дополнительную информацию о сохранении системных переменных и файле mysqld-auto.cnf см. в разделе 7.1.9.3 «Сохранённые системные переменные».

Привилегии, необходимые для RESET PERSIST, зависят от типа удаляемой системной переменной:

Для динамических системных переменных требуется привилегия SYSTEM_VARIABLES_ADMIN (или устаревшая привилегия SUPER).
Для системных переменных только для чтения требуется привилегия SYSTEM_VARIABLES_ADMIN и PERSIST_RO_VARIABLES_ADMIN.

См. раздел 7.1.9.1 «Привилегии системных переменных».

В зависимости от того, присутствуют ли имя переменной и IF EXISTS-клаузы, команда RESET PERSIST имеет следующие формы:

Чтобы удалить все сохранённые переменные из mysqld-auto.cnf, используйте RESET PERSIST без указания имени системной переменной:
```
RESET PERSIST;
```
Вам должны быть предоставлены привилегии на удаление как динамических, так и системных переменных только для чтения, если mysqld-auto.cnf содержит оба типа переменных.
Чтобы удалить конкретную сохранённую переменную из mysqld-auto.cnf, укажите её имя в команде:
```
RESET PERSIST system_var_name;
```
Это включает в себя системные переменные плагинов, даже если плагин в настоящее время не установлен. Если переменной нет в файле, возникает ошибка.
Чтобы удалить конкретную сохранённую переменную из mysqld-auto.cnf, но вывести предупреждение вместо ошибки, если переменная не найдена в файле, добавьте IF EXISTS-клаузу к предыдущему синтаксису:
```
RESET PERSIST IF EXISTS system_var_name;
```

RESET PERSIST не зависит от значения системной переменной persisted_globals_load.

RESET PERSIST влияет на содержимое таблицы Performance Schema persisted_variables, поскольку содержимое таблицы соответствует содержимому файла mysqld-auto.cnf. С другой стороны, поскольку RESET PERSIST не изменяет значения переменных, она не влияет на содержимое таблицы Performance Schema variables_info до перезапуска сервера.

Дополнительную информацию о вариантах команды RESET, которые очищают состояние других операций сервера, см. в разделе 15.7.8.6 «Команда RESET».