8.8.4 Rescanning a Cluster — MySQL Shell 9.2

8.8.4 Пересканирование кластера

Если вы внесли изменения в конфигурацию кластера за пределами команд AdminAPI, например, вручную изменили конфигурацию экземпляра для решения проблем с конфигурацией или после потери экземпляра, вам необходимо обновить метаданные InnoDB Cluster, чтобы они соответствовали текущей конфигурации экземпляров. В этих случаях используйте операцию Cluster.rescan(), которая позволяет обновить метаданные InnoDB Cluster вручную или с помощью интерактивного мастера. Операция Cluster.rescan() может обнаруживать новые активные экземпляры, которые не зарегистрированы в метаданных, и добавлять их, а также устаревшие экземпляры (больше не активные), всё ещё зарегистрированные в метаданных, и удалять их. Вы можете автоматически обновить метаданные в зависимости от экземпляров, найденных командой, или указать список адресов экземпляров для добавления в метаданные или удаления из метаданных. Вы также можете обновить режим топологии, хранящийся в метаданных, например, после перехода от однородного первичного режима к многородному первичному режиму за пределами AdminAPI.

Примечание

установлено в максимальное значение в кластерах реплик. Исходное значение сохраняется в схеме метаданных и восстанавливается операцией Cluster.rescan() в случае переключения или аварийного переключения.

Синтаксис команды: Cluster.rescan([options]). Словарь options поддерживает следующее:

addInstances: список с данными подключения новых активных экземпляров для добавления в метаданные или “авто” для автоматического добавления отсутствующих экземпляров в метаданные. Значение “авто” нечувствительно к регистру.
- Указанные в списке экземпляры добавляются в метаданные без запроса подтверждения.
- В интерактивном режиме вас попросят подтвердить добавление вновь обнаруженных экземпляров, которые не включены в опцию addInstances.
- В неинтерактивном режиме вновь обнаруженные экземпляры, не включенные в опцию addInstances, сообщаются в выводе, но вас не просят добавлять их.
removeInstances: список с данными подключения устаревших экземпляров для удаления из метаданных или “авто” для автоматического удаления устаревших экземпляров из метаданных.
- Указанные в списке экземпляры удаляются из метаданных без запроса подтверждения.
- В интерактивном режиме вас попросят подтвердить удаление устаревших экземпляров, которые не включены в опцию removeInstances.
- В неинтерактивном режиме устаревшие экземпляры, не включенные в опцию removeInstances, сообщаются в выводе, но вас не просят удалить их.
updateViewChangeUuid: логическое значение, используемое для указания, должен ли быть сгенерирован и установлен параметр системной переменной на экземплярах кластера.

Примечание

Это не требуется для кластеров, работающих под MySQL Server 8.3.0 или выше.

Эта системная переменная предоставляет альтернативный UUID для событий изменения представлений, генерируемых группой. Для экземпляров MySQL Server версии 8.0.27 и выше, для InnoDB Cluster, который является частью InnoDB ClusterSet, системная переменная требуется и должна быть установлена в одинаковое значение на всех серверах-членах кластера. InnoDB Cluster, созданный с помощью команды dba.createCluster(), генерирует и устанавливает значение для системной переменной на всех серверах-членах. InnoDB Cluster, созданный до MySQL Shell 8.0.27, может не иметь установленной системной переменной, но процесс создания InnoDB ClusterSet проверяет это и завершается с предупреждением, если её нет.

По умолчанию updateViewChangeUuid установлено в false, и если системная переменная не найдена или не совпадает ни в одном из экземпляров, возвращается сообщение об ошибке, информирующее вас о необходимости установить значение для системной переменной и перезагрузить InnoDB Cluster. Если вы установите updateViewChangeUuid в true, операция пересканирования генерирует и устанавливает значение для на всех серверах-членах, после чего вам необходимо перезапустить кластер для внедрения изменений. Команда Cluster.rescan() автоматически генерирует и устанавливает значение системной переменной так же, как если бы true было установлено, с требуемой перезагрузкой кластера для внедрения изменений. После перезагрузки кластера можно повторить процесс создания InnoDB ClusterSet.
upgradeCommProtocol: логическое значение, используемое для указания, следует ли обновлять версию протокола связи Group Replication (true) или нет (false) до версии, поддерживаемой экземпляром в кластере, имеющим самую низкую версию MySQL. По умолчанию версия протокола связи не обновляется (false). Операции AdminAPI, вызывающие изменение топологии, возвращают сообщение, если версия протокола связи может быть обновлена, и вы можете использовать этот параметр для проведения обновления в подходящее время. Рекомендуется обновлять до самой последней версии протокола связи Group Replication, чтобы поддерживать самые последние функции, такие как фрагментация сообщений для больших транзакций. Для получения дополнительной информации см. .
- Если значение true, то версия протокола связи Group Replication обновляется до версии, поддерживаемой экземпляром в кластере с самой низкой версией MySQL.
- Если значение false, то версия протокола связи Group Replication не обновляется.