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

在此示例中

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

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

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

确定一个可以接管主集群的合适的副本集群。副本集群是否适合进行控制切换取决于其全局状态，如 clusterSet.status() 命令所示

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

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

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 集群管理员帐户检索的 ClusterSet 对象，以及 dba.getClusterSet() 或 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 将执行以下任务

再次使用 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，以及如何将集群再次设置为主集群。