Используйте операцию ReplicaSet.setPrimaryInstance(), чтобы безопасно изменить первичный экземпляр реплики на другой экземпляр. Текущий первичный экземпляр понижается до вторичного и становится только для чтения, в то время как повышенный экземпляр становится новым первичным и становится доступным для чтения и записи. Все остальные вторичные экземпляры обновляются для репликации с нового первичного. Экземпляры MySQL Router, которые были запущены с репликой автоматически начинают перенаправлять клиенты чтения-записи на новый первичный экземпляр.

Для возможности безопасного изменения первичного экземпляра все экземпляры ReplicaSet должны быть доступны для MySQL Shell и иметь согласованные GTID_EXECUTED наборы. Если первичный экземпляр недоступен и нет способа его восстановить, принудительное переключение может быть единственным вариантом, см. Раздел 10.8, «Принудительное назначение нового первичного экземпляра».

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