6.1 Using MySQL AdminAPI — MySQL Shell 9.2

6.1 Использование MySQL AdminAPI

AdminAPI предоставляется MySQL Shell. К AdminAPI можно получить доступ через глобальную переменную dba и её связанные методы. Методы переменной dba обеспечивают операции, позволяющие развертывать, настраивать и администрировать InnoDB Cluster, InnoDB ClusterSet и InnoDB ReplicaSet. Например, используйте метод dba.createCluster() для создания InnoDB Cluster. Кроме того, AdminAPI поддерживает администрирование некоторых задач, связанных с MySQL Router, таких как создание или обновление учётной записи пользователя, работающей с InnoDB Cluster, InnoDB ClusterSet и InnoDB ReplicaSet.

AdminAPI поддерживает следующие сценарии развертывания:

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

Важно

Развертывание AdminAPI в песочнице не подходит для использования в полной производственной среде.

MySQL Shell предоставляет два языка программирования, JavaScript и Python, а также родной SQL-режим. В этом руководстве MySQL Shell используется в основном в режиме JavaScript. При запуске MySQL Shell он по умолчанию находится в режиме JavaScript. Переключиться на режимы можно, выполнив \js для режима JavaScript и \py для режима Python. Убедитесь, что вы находитесь в режиме JavaScript, выполнив \js.

Важно

MySQL Shell позволяет подключаться к серверам через сокет-соединение, но AdminAPI требует TCP-соединений с серверным экземпляром. Соединения на основе сокетов в AdminAPI не поддерживаются.

Эта секция предполагает знакомство с MySQL Shell; см. MySQL Shell 9.2 для получения дополнительной информации. MySQL Shell также предоставляет онлайн-справочную информацию для AdminAPI. Чтобы перечислить все доступные dba команды, используйте метод dba.help(). Для получения онлайн-помощи по конкретному методу используйте общий формат object.help('methodname'). Например, используя JavaScript:

mysql-js> dba.help('getCluster')

Retrieves a cluster from the Metadata Store.

SYNTAX

  dba.getCluster([name][, options])

WHERE

  name: Parameter to specify the name of the cluster to be returned.
  options: Dictionary with additional options.
  ...

Или используя Python:

mysql-py>dba.help('get_cluster')
NAME
      get_cluster - Retrieves a cluster from the Metadata Store.

SYNTAX
      dba.get_cluster([name][, options])

WHERE
      name: Parameter to specify the name of the cluster to be returned.
      options: Dictionary with additional options.
...

В дополнение к этой документации, имеется документация разработчика для всех методов AdminAPI в справочнике MySQL Shell JavaScript API или MySQL Shell Python API, доступных по адресу Подключения и API.