Если вы еще этого не сделали, установите экземпляры MySQL Router, соответствующие вашей топологии. Рекомендуемая развертка MySQL Router — на том же хосте, что и клиентское приложение. При использовании развертывания в песочнице все работает на одном хосте, поэтому вы развертываете MySQL Router на том же хосте. При использовании производственной развертки мы рекомендуем развернуть по одному экземпляру MySQL Router на каждую машину, используемую для размещения одного из ваших клиентских приложений. Также возможно развернуть MySQL Router на общей машине, через которую подключаются ваши экземпляры приложений. Инструкции см. в Установка MySQL Router.

Подключитесь к любому активному экземпляру сервера в развертывании InnoDB ClusterSet, используя учетную запись администратора InnoDB Cluster. Вы также можете использовать учетную запись конфигурации сервера InnoDB Cluster, у которой также есть необходимые разрешения. Получите объект ClusterSet с помощью команды dba.getClusterSet() или cluster.getClusterSet(). Важно получить объект ClusterSet, когда вы подключены к экземпляру сервера с помощью соответствующей учетной записи. По умолчанию учетная запись пользователя, хранящаяся в объекте, используется для некоторых операций, независимо от учетной записи, которую вы указываете при подключении. Например:

mysql-js> \connect admin2@127.0.0.1:3310
...
mysql-js> myclusterset = dba.getClusterSet()
<ClusterSet:testclusterset>

В этом примере:

Проверьте работоспособность развертывания InnoDB ClusterSet, выполнив команду clusterSet.status() в MySQL Shell, подключившись к любому серверу-члену кластера. Например:

mysql-js> myclusterset.status({extended: 1})

Выберите расширенный вывод, чтобы увидеть подробный статус кластеров в топологии InnoDB ClusterSet. Это предоставит вам хост и порт для каждого сервера-члена, так что вы сможете выбрать один для начальной настройки MySQL Router. Более подробную информацию см. в разделе 9.7 «Статус и топология InnoDB ClusterSet».

Для каждого экземпляра MySQL Router выполните команду mysqlrouter в соответствующей оболочке на экземпляре, где установлен MySQL Router, для начальной настройки MySQL Router относительно InnoDB ClusterSet. В этом примере используется параметр force, поскольку MySQL Router ранее был настроен относительно первичного InnoDB Cluster:

$> mysqlrouter --bootstrap icadmin@127.0.0.1:3310 --account=myRouter1 --name='Rome1' --force
Please enter MySQL password for icadmin:
# Bootstrapping system MySQL Router instance...

Please enter MySQL password for myRouter1:
- Creating account(s) (only those that are needed, if any)
- Verifying account (using it to run SQL queries that would be run by Router)
- Storing account in keyring
- Creating configuration C:/Program Files/MySQL/MySQL Router 8.0/mysqlrouter.conf

# MySQL Router configured for the ClusterSet 'testclusterset'

After this MySQL Router has been started with the generated configuration

    > net start mysqlrouter
or
    > C:\Program Files\MySQL\MySQL Router 8.0\bin\mysqlrouter.exe -c C:/Program Files/MySQL/MySQL Router 8.0/mysqlrouter.conf

ClusterSet 'testclusterset' can be reached by connecting to:

## MySQL Classic protocol

- Read/Write Connections: localhost:6446
- Read/Only Connections:  localhost:6447

## MySQL X protocol

- Read/Write Connections: localhost:6448
- Read/Only Connections:  localhost:6449

В этом примере:

MySQL Router подключается к экземпляру сервера и извлекает метаданные InnoDB ClusterSet. Процесс аналогичен процессу начальной настройки MySQL Router относительно отдельного InnoDB Cluster. Более подробную информацию о процессе см. в разделе 7.3 «Развертывание MySQL Router».

После начальной настройки каждого экземпляра MySQL Router проверьте, что он теперь правильно настроен относительно развертывания InnoDB ClusterSet, выполнив команду clusterSet.listRouters() в MySQL Shell, подключившись к любому серверу-члену в InnoDB ClusterSet. Команда возвращает детали всех зарегистрированных экземпляров MySQL Router или указанного экземпляра маршрутизатора. Например:

mysql-js> myclusterset.listRouters()
{
    "domainName": "testclusterset",
    "routers": {
       "mymachine::Rome1": {
            "hostname": "mymachine",
            "lastCheckIn": 2021-10-15 11:58:37,
            "roPort": 6447,
            "roXPort": 6449,
            "rwPort": 6446,
            "rwXPort": 6448,
            "targetCluster": "primary",
            "version": "8.0.27"
        },
        "mymachine2::Rome2": {
            "hostname": "mymachine2",
            "lastCheckIn": 2021-10-15 11:58:37,
            "roPort": 6447,
            "roXPort": 6449,
            "rwPort": 6446,
            "rwXPort": 6448,
            "targetCluster": "primary",
            "version": "8.0.27"
        }
    }
}

Дополнительную информацию см. в разделе «Статус MySQL Router для InnoDB ClusterSet».

Чтобы увидеть параметры маршрутизации, установленные для каждого экземпляра MySQL Router, и глобальную политику для развертывания InnoDB ClusterSet, выполните команду clusterSet.routingOptions() в MySQL Shell, подключившись к любому серверу-члену в развертывании InnoDB ClusterSet. Например:

mysql-js> myclusterset.routingOptions()
{
    "domainName": "testclusterset",
    "global": {
        "invalidated_cluster_policy": "drop_all",
        "target_cluster": "primary"
    },
    "routers": {
        "mymachine::Rome1":  {
            "target_cluster": "primary"
            "invalidated_cluster_policy": "accept_ro"
        },
        "mymachine2::Rome2": {}
    }
}

По умолчанию экземпляр MySQL Router отправляет трафик в первичный кластер и запрещает трафик чтения и записи в кластер, помеченный как INVALIDATED. Дополнительную информацию и объяснение вывода команды clusterSet.routingOptions() см. в разделе «Статус MySQL Router для InnoDB ClusterSet».

Если вы хотите изменить глобальную политику маршрутизации или политику маршрутизации для отдельного экземпляра MySQL Router, выполните команду clusterSet.setRoutingOption() в MySQL Shell, подключившись к любому серверу-члену в развертывании InnoDB ClusterSet. Вы можете задать только один параметр маршрутизации за раз. Экземпляру MySQL Router требуется несколько секунд, чтобы принять изменения в политике маршрутизации.

Например, эта команда, выданная для InnoDB ClusterSet myclusterset, изменяет целевой кластер для экземпляра MySQL Router на кластер clustertwo:

mysql-js> myclusterset.setRoutingOption('mymachine::Rome1', 'target_cluster', 'clustertwo')
Routing option 'target_cluster' successfully updated in router 'Rome1'.

В этом примере myclusterset — переменная для объекта ClusterSet, Rome1 — имя экземпляра MySQL Router, а clustertwo — имя конкретного целевого кластера.

Чтобы установить политику маршрутизации для экземпляра обратно на следование первичному, выполните эту команду:

mysql-js> myclusterset.setRoutingOption('mymachine::Rome1', 'target_cluster', 'primary')
Routing option 'target_cluster' successfully updated in router 'Rome1'.

Чтобы очистить политику маршрутизации для экземпляра, используйте команду clusterSet.setRoutingOption() для установки соответствующей политики на значение null. Например:

mysql-js> myclusterset.setRoutingOption('mymachine::Rome1', 'target_cluster', null)
Routing option 'target_cluster' successfully updated in router 'Rome1'.

Более подробную информацию об имеющихся параметрах маршрутизации см. в разделе 7.4 «Параметры маршрутизации».

Чтобы установить глобальную политику маршрутизации, не указывайте экземпляр MySQL Router, а только имя политики и значение. Дополнительную информацию и объяснение доступных параметров маршрутизации см. в разделе «Статус MySQL Router для InnoDB ClusterSet».

Когда вы готовы начать прием подключений, настройте приложения для использования портов, на которых MySQL Router прослушивает трафик для развертывания InnoDB ClusterSet. Затем запустите экземпляры MySQL Router с помощью соответствующей оболочки или скрипта на серверах, где установлен MySQL Router. См. Запуск MySQL Router.