15.7.8.7 RESET PERSIST Statement — MySQL 8.4

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».