1.2.1 MySQL Router Read Replica Support — MySQL Router 8.4

1.2.1 Поддержка чтений реплик MySQL Router

MySQL Router считывает значения, определенные в поле метаданных, v2_router_options.router_options.read_only_targets, для получения маршрутизации информации для чтений только для чтения.

v2_router_options.router_options.read_only_targets заполняется методом AdminAPI cluster.setRoutingOption(), который устанавливает политику маршрутизации на одно из следующих значений, используя опцию read_only_targets:

all: все чтений реплики и вторичные члены кластера используются для чтений только для чтения.
read_replicas: только чтений реплики используются для чтений только для чтения.
secondaries: только вторичные члены кластера используются для чтений только для чтения.

Примечание

Если read_only_targets отсутствует или установлено значение, отличное от all, read_replicas или secondaries, MySQL Router по умолчанию устанавливает secondaries и записывает сообщение об ошибке.

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

Обработка ошибок

MySQL Router не маршрутизирует соединения с чтений репликами в следующих ситуациях:

Если в кластере нет кворума.
Если все члены кластера находятся в состоянии OFFLINE.
Если ни один член кластера недоступен при проверке состояния Group Replication.

Политика маршрутизации MySQL Router зависит от конфигурации следующим образом:

Если состояние кластера INVALID и invalidated_cluster_policy установлено на drop_all, чтений реплики не используются для новых подключений для чтения только для чтения, и все существующие подключения к чтений репликам прерываются.
Если состояние кластера INVALID и invalidated_cluster_policy установлено на allow_ro, чтений реплики используются для новых подключений для чтения только для чтения, а существующие подключения к чтений репликам остаются без изменений.

MySQL Router использует стандартный механизм карантина для чтений реплик, как определено параметрами конфигурации desination_status. См. Варианты статуса назначения.