6.3 Получение объекта обработчика
При работе с AdminAPI вы используете объект обработчика, который представляет собой InnoDB Кластер, InnoDB Набор Кластеров или InnoDB Репликационный Набор. Вы присваиваете этот объект переменной и затем используете доступные операции для мониторинга и администрирования InnoDB Кластера, InnoDB Набора Кластеров или InnoDB Репликационного Набора.
Для получения объекта обработчика необходимо установить соединение с одним из активных экземпляров, включая чтение реплик, которые принадлежат InnoDB Кластеру, InnoDB Набору Кластеров или InnoDB Репликационному Набору. Например, когда вы создаёте кластер с помощью dba.createCluster(), операция возвращает объект Cluster, который можно присвоить переменной. Вы используете этот объект обработчика для работы с кластером. Например, для добавления экземпляров или проверки статуса кластера. Если вы хотите получить объект Cluster снова в будущем, например, после перезапуска MySQL Shell, используйте функцию dba.getCluster([. Например, на языке JavaScript:name],[options])
mysql-js> var cluster1 = dba.getCluster()
Или на языке Python:
mysql-py> cluster1 = dba.get_cluster()
Для получения объекта ClusterSet, представляющего развертывание InnoDB Набора Кластеров, используйте функцию dba.getClusterSet() или cluster.getClusterSet()
mysql-js> myclusterset = dba.getClusterSet()
Или на языке Python:
mysql-py> myclusterset = dba.get_cluster_set()
При использовании объекта ClusterSet, экземпляр сервера, из которого вы его получили, должен оставаться онлайн в InnoDB Наборе Кластеров. Если этот экземпляр сервера выходит из строя, объект больше не работает, и вам необходимо получить его снова с сервера, который по-прежнему онлайн в InnoDB Наборе Кластеров.
Используйте операцию dba.getReplicaSet() для получения объекта ReplicaSet. Например, на языке JavaScript:
mysql-js> var replicaset1 = dba.getReplicaSet()
Или на языке Python:
mysql-py> replicaset1 = dba.get_replica_set()
Если вы не укажете name, то возвращается объект по умолчанию. Возвращаемый объект использует новую сессию, независимую от глобальной сессии MySQL Shell. Это гарантирует, что если вы измените глобальную сессию MySQL Shell, объект Cluster, ClusterSet или ReplicaSet сохранит своё соединение с экземпляром сервера.
По умолчанию MySQL Shell пытается подключиться к первичному экземпляру при получении обработчика. Если первичный экземпляр недоступен, соединение устанавливается со вторичным.
© 2025 Oracle
Licensed under the GPLv2 License.
