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

mysql-js> \connect [email protected]:3310
Creating a session to '[email protected]:3310'
Please provide the password for '[email protected]:3310': ********
Save password for '[email protected]: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:[email protected]:3310>
mysql-js> myclusterset = dba.getClusterSet()
<ClusterSet:testclusterset>

在此示例中：

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

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

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

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

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

通过连接到 InnoDB ClusterSet 部署中的任何成员服务器并在 MySQL Shell 中发出 clusterSet.routingOptions() 命令，检查为每个 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() 命令，命名将接管为新的主集群的副本集群。使用您使用 InnoDB Cluster 管理员帐户通过 dba.getClusterSet() 或 cluster.getClusterSet() 命令检索到的 ClusterSet 对象。例如

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 将执行以下任务

再次使用 extended 选项发出 clusterSet.status() 命令，以验证 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 以及如何使集群再次成为主集群。