使用 MySQL Shell，使用 InnoDB 叢集管理員帳戶 (使用 cluster.setupAdminAccount() 建立) 連線到主要叢集或其中一個複本叢集中的任何成員伺服器。您也可以使用 InnoDB 叢集伺服器組態帳戶，該帳戶也具有必要的權限。使用 dba.getClusterSet() 或 cluster.getClusterSet() 命令取得 ClusterSet 物件。務必使用 InnoDB 叢集管理員帳戶或伺服器組態帳戶，以便儲存在 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>

在此範例中

使用 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，以及如何再次將叢集設為主要叢集。