使用 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": "主要叢集名稱"），它們將不會將流量重新導向至新的主要叢集。在這種情況下，如果適用於應用程式，您可以使用 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": "新主要叢集名稱"）。

發出 clusterSet.setPrimaryCluster() 命令，指定將接管成為新主要叢集的複本叢集。使用您使用 InnoDB 叢集管理員帳戶，透過 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，以及如何再次將叢集設為主要叢集。