使用 MySQL Shell，使用 InnoDB Cluster 管理员帐户（使用创建 cluster.setupAdminAccount()）连接到主集群或其中一个副本集群中的任何成员服务器。您还可以使用 InnoDB Cluster 服务器配置帐户，该帐户也具有所需的权限。使用或 命令获取 ClusterSet对象 。使用 InnoDB Cluster 管理员帐户或服务器配置帐户很重要，这样存储在 对象中的默认用户帐户具有正确的权限。例如： dba.getClusterSet()cluster.getClusterSet()ClusterSet

mysql-js> \connect admin2@127.0.0.1:3310
Creating a session to 'admin2@127.0.0.1:3310'
Please provide the password for 'admin2@127.0.0.1:3310': ********
Save password for 'admin2@127.0.0.1:3310'? [Y]es/[N]o/Ne[v]er (default No):
Fetching schema names for autocompletion... Press ^C to stop.
Closing old connection...
Your MySQL connection id is 52
Server version: 8.0.27-commercial MySQL Enterprise Server - Commercial
No default schema selected; type \use <schema> to set one.
<ClassicSession:admin2@127.0.0.1:3310>
mysql-js> myclusterset = dba.getClusterSet()
<ClusterSet:testclusterset>

在这个例子中：

clusterSet.status() 使用MySQL Shell 中 的 AdminAPI 命令检查整个 InnoDB ClusterSet 部署的状态 。使用该extended 选项查看部署中所有集群的详细信息，并检查是否存在任何问题。例如：

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

有关输出的解释，请参阅 第 8.6 节，“InnoDB ClusterSet 状态和拓扑”。

确定可以作为主集群接管的合适的副本集群。副本集群是否有资格进行受控切换取决于其全局状态，如以下 clusterSet.status() 命令所报告：

具有全局状态的副本集群在集群上 OK_NOT_CONSISTENT有一组事务（GTID 集）与主集群上的 GTID 集不一致。InnoDB ClusterSet 不允许在这种状态下控制切换到集群，因为客户端会访问不正确的数据。如果集群在可用选项中具有最新的事务集，则可以进行紧急故障转移。

clusterSet.routingOptions() 通过在连接到 InnoDB ClusterSet 部署中的任何成员服务器时在 MySQL Shell 中 发出命令，检查为每个 MySQL Router 实例设置的路由选项，以及 InnoDB ClusterSet 部署的全局策略 。例如：

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

默认情况下，MySQL Router 实例将流量发送到 InnoDB ClusterSet 部署中当前主要的集群。如果所有 MySQL Router 实例都设置为跟随主 ( "target_cluster": "primary")，则流量将在切换后的几秒钟内自动重定向到新的主集群。如果没有为 MySQL Router 实例显示路由选项，如上例所示Rome2，这意味着该实例没有设置该策略，它遵循全局策略。

如果任何实例设置为按名称 ( ) 定位当前主集群，它们将不会将流量重定向到新的主集群。在那种情况下，如果适合应用程序，您可以使用该 命令更改这些实例的路由策略。您可以更改这些实例以跟随主要 ( )，在这种情况下，现在可以设置该选项。例如： "target_cluster": "name_of_primary_cluster"clusterSet.setRoutingOption()"target_cluster": "primary"

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

在此示例中， myclusterset是ClusterSet对象的变量， Rome1是 MySQL Router 实例的名称。

或者您可以指定将接管主集群的副本集群，在这种情况下，在切换发生后设置选项 ( )，当您验证它是否有效时。 "target_cluster": "name_of_new_primary_cluster"

发出 clusterSet.setPrimaryCluster() 命令，命名将接管的副本集群作为新的主集群。ClusterSet 将您使用 InnoDB Cluster 管理员帐户检索 到的对象与dba.getClusterSet()or cluster.getClusterSet() 命令一起使用。例如：

mysql-js> myclusterset.setPrimaryCluster('clustertwo')
Switching the primary cluster of the clusterset to 'clustertwo'
* Verifying clusterset status
** Checking cluster clustertwo
  Cluster 'clustertwo' is available
** Checking cluster clusterone
  Cluster 'clusterone' is available

* Refreshing replication account of demoted cluster
* Synchronizing transaction backlog at 127.0.0.1:4410
** Transactions replicated  ############################################################  100%
* Updating metadata

* Updating topology
** Changing replication source of 127.0.0.1:3330 to 127.0.0.1:4410
* Acquiring locks in replicaset instances
** Pre-synchronizing SECONDARIES
** Acquiring global lock at PRIMARY
** Acquiring global lock at SECONDARIES

* Synchronizing remaining transactions at promoted primary
** Transactions replicated  ############################################################  100%
* Updating replica clusters
Cluster 'clustertwo' was promoted to PRIMARY of the clusterset. The PRIMARY instance is '127.0.0.1:4410'

对于 clusterSet.setPrimaryCluster() 命令：

当您发出 clusterSet.setPrimaryCluster() 命令时，MySQL Shell 会检查目标副本集群是否符合接管为主集群的要求，如果不符合则返回错误。如果目标副本集群满足要求，则MySQL Shell执行以下任务：

使用该选项再次发出 clusterSet.status() 命令extended，以验证 InnoDB ClusterSet 部署的状态。

如果您有任何 MySQL Router 实例要切换到新的主集群，请立即执行。例如：

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

在此示例中， myclusterset是ClusterSet对象的变量， Rome1是 MySQL Router 实例 clustertwo的名称，是要定位的特定集群的名称。完成后，发出 clusterSet.routingOptions() 命令以检查所有 MySQL Router 实例现在是否正确路由。

现在您可以使用旧的主集群来解决问题或进行维护。如果您必须在切换过程中使任何副本集群失效，您也可以修复它们并将它们添加回 InnoDB ClusterSet。 第 8.9 节，“InnoDB ClusterSet 修复和重新加入”解释了如何修复集群问题，如何将集群重新加入 InnoDB ClusterSet，以及如何使集群再次成为主集群。