您可以針對 InnoDB 叢集或 InnoDB ReplicaSet 引導多個 MySQL Router 執行個體。若要顯示所有已註冊的 MySQL Router 執行個體清單，請執行

Cluster.listRouters()

結果會提供每個已註冊的 MySQL Router 執行個體的相關資訊，例如其在中繼資料中的名稱、主機名稱、連接埠等等。例如，執行下列 JavaScript 命令

mysql-js> Cluster.listRouters()
{
    "clusterName": "example",
    "routers": {
        "ic-1:3306": {
            "hostname": "ic-1:3306",
            "lastCheckIn": "2020-01-16 11:43:45",
            "roPort": 6447,
            "roXPort": 64470,
            "rwPort": 6446,
            "rwXPort": 64460,
            "version": "8.0.19"
        }
    }
}

或執行下列 Python 命令

mysql-py> Cluster.list_routers()
{
    "clusterName": "example",
    "routers": {
        "ic-1:3306": {
            "hostname": "ic-1:3306",
            "lastCheckIn": "2020-01-16 11:43:45",
            "roPort": 6447,
            "roXPort": 64470,
            "rwPort": 6446,
            "rwXPort": 64460,
            "rwSplitPort": 6450,
            "version": "8.0.19"
        }
    }
}

傳回的資訊會顯示

此外，Cluster.listRouters() 作業可以顯示不支援 MySQL Shell 支援的中繼資料版本的執行個體清單。使用 onlyUpgradeRequired 選項。例如，執行 Cluster.listRouters({'onlyUpgradeRequired':'true'})。

傳回的清單只會顯示已向 Cluster 註冊，且需要升級其資料的中繼資料的 MySQL Router 執行個體。如需詳細資訊，請參閱第 6.11 節，「升級中繼資料結構描述」。

MySQL Router 執行個體不會自動從中繼資料移除，因此，例如，當您引導更多執行個體時，InnoDB 叢集中繼資料會包含越來越多的執行個體參考。若要從叢集中繼資料移除已註冊的 MySQL Router 執行個體，請使用 Cluster.removeRouterMetadata(router) 作業。

使用 Cluster.listRouters() 作業來取得您要移除的 MySQL Router 執行個體的名稱，並將其以 router 傳入。例如，假設向叢集註冊的 MySQL Router 執行個體為

mysql-js> Cluster.listRouters(){

    "clusterName": "testCluster",
    "routers": {
        "myRouter1": {
            "hostname": "example1.com",
            "lastCheckIn": null,
            "roPort": "6447",
            "rwPort": "6446"
            "version": null
        },
        "myRouter2": {
            "hostname": "example2.com",
            "lastCheckIn": "2019-11-27 16:25:00",
            "roPort": "6447",
            "rwPort": "6446"
            "version": "8.0.19"
        }
    }
}

基於名為 「myRouter1」 的執行個體的 「lastCheckIn」 和 「version」 皆為 null 的事實。執行下列 JavaScript 命令，從中繼資料移除此舊執行個體

mysql-js> cluster.removeRouterMetadata('myRouter1')

或執行下列 Python 命令

mysql-py> cluster.remove_router_metadata('myRouter1')

透過從 InnoDB 叢集中繼資料移除，指定之 MySQL Router 執行個體會從叢集中取消註冊。

          cluster.routerOptions({options})

$> cluster.routerOptions()
     {
          "clusterName": "Cluster1",
          "configuration": {
            "routing_rules": {
              "invalidated_cluster_policy": "drop_all",
              "read_only_targets": "secondaries",
              "stats_updates_frequency": -1,
              "tags": {},
              "unreachable_quorum_allowed_traffic": "none",
              "use_replica_primary_as_rw": false
            }
        },
        "routers": {
            "host1::router_test": {
                "configuration": {
                }
            }
        }
    }