15.4.1.2 RESET BINARY LOGS AND GTIDS Statement — MySQL 8.4

15.4.1.2 Заявление RESET BINARY LOGS AND GTIDS

Примечание

Это утверждение заменяет устаревшее утверждение RESET MASTER, которое больше не поддерживается.

RESET BINARY LOGS AND GTIDS [TO binary_log_file_index_number]

Предупреждение

Используйте это утверждение с осторожностью, чтобы убедиться, что вы не потеряете нужные данные журналов двоичных логов и историю выполнения GTID.

Для использования RESET BINARY LOGS AND GTIDS необходимо разрешение RELOAD.

Для сервера, где включён журнал двоичных логов (log_bin имеет значение ON), RESET BINARY LOGS AND GTIDS удаляет все существующие файлы двоичных логов и сбрасывает индексный файл двоичных логов, возвращая сервер в состояние до начала записи двоичных логов. Создаётся новый пустой файл двоичного лога для перезапуска записи двоичных логов.

Для сервера, где используются GTID (gtid_mode имеет значение ON), выдача RESET BINARY LOGS AND GTIDS сбрасывает историю выполнения GTID. Значение системной переменной gtid_purged устанавливается в пустую строку (''), глобальное значение (но не сессионное) системной переменной gtid_executed устанавливается в пустую строку, а таблица mysql.gtid_executed очищается (см. Таблицу mysql.gtid_executed). Если на сервере с поддержкой GTID включена запись двоичных логов, RESET BINARY LOGS AND GTIDS также сбрасывает журнал двоичных логов, как описано выше. Обратите внимание, что RESET BINARY LOGS AND GTIDS — это метод сброса истории выполнения GTID даже если сервер с поддержкой GTID является репликой, где запись двоичных логов отключена; RESET REPLICA не влияет на историю выполнения GTID. Для получения дополнительной информации о сбросе истории выполнения GTID см. Сброс истории выполнения GTID.

Выдача RESET BINARY LOGS AND GTIDS без необязательной части TO удаляет все файлы двоичных логов, перечисленные в индексном файле, сбрасывает индексный файл двоичных логов в пустое состояние и создаёт новый файл двоичного лога, начиная с 1. Используйте необязательную часть TO, чтобы начать индекс файла двоичных логов с номера, отличного от 1 после сброса.

Убедитесь, что вы используете разумное значение для номера индекса. Если вы введёте неправильное значение, вы можете исправить это, выдав ещё одно утверждение RESET BINARY LOGS AND GTIDS с необязательной частью TO. Если вы не исправите значение, выходящее за пределы допустимого диапазона, сервер не сможет перезапуститься.

Следующий пример демонстрирует использование части TO:

RESET BINARY LOGS AND GTIDS TO 1234;

SHOW BINARY LOGS;
+-------------------+-----------+-----------+
| Log_name          | File_size | Encrypted |
+-------------------+-----------+-----------+
| source-bin.001234 |       154 | No        |
+-------------------+-----------+-----------+

Важно

Действия RESET BINARY LOGS AND GTIDS без необязательной части TO отличаются от действий PURGE BINARY LOGS по 2 ключевым признакам:

RESET BINARY LOGS AND GTIDS удаляет все файлы двоичных логов, перечисленные в индексном файле, оставляя только один пустой файл двоичного лога с числовым суффиксом .000001, в то время как нумерация не сбрасывается командой PURGE BINARY LOGS.
RESET BINARY LOGS AND GTIDS не предназначена для использования при работе реплик. Поведение RESET BINARY LOGS AND GTIDS при использовании во время работы реплик является неопределённым (и, следовательно, не поддерживается), в то время как PURGE BINARY LOGS может безопасно использоваться при работе реплик.

См. также Раздел 15.4.1.1, «Утверждение PURGE BINARY LOGS».

RESET BINARY LOGS AND GTIDS без необязательной части TO может оказаться полезной при первоначальной настройке источника и реплики, позволяя проверить настройку следующим образом:

Запустите источник и реплику и начните репликацию (см. Раздел 19.1.2, «Настройка репликации, основанной на позиции файла двоичного лога»).
Выполните несколько тестовых запросов на источнике.
Проверьте, что запросы были реплицированы на реплику.
При корректной работе репликации выполните STOP REPLICA и RESET REPLICA (оба на реплике), затем проверьте отсутствие нежелательных данных от тестовых запросов на реплике. После этого выполните RESET BINARY LOGS AND GTIDS (также на реплике) для удаления двоичных логов и связанных с ними идентификаторов транзакций.
Удалите нежелательные данные из источника, затем выполните RESET BINARY LOGS AND GTIDS для удаления записей и идентификаторов двоичных логов, связанных с ним.

После проверки настройки, сброса источника и реплики и гарантии отсутствия нежелательных данных или файлов двоичных логов, сгенерированных при тестировании, на источнике или реплике, вы можете запустить реплику и начать репликацию.