定義
listShardslistShardsコマンドは、シャーディングされたクラスター内の構成されたシャードのリストを返します。listShardsはmongosインスタンスでのみ使用可能であり、adminデータベースに対して発行する必要があります。
互換性
このコマンドは、次の環境でホストされている配置で使用できます。
- MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
構文
このコマンドの構文は、次のとおりです。
db.runCommand( { listShards: 1 })例
次の操作は、listShards mongosadminデータベースに対して を実行します。
db.adminCommand({ listShards: 1 })次のドキュメントは、 listShardsコマンドからの出力の例えです。
{ "shards": [ { "_id": "shard01", "host": "shard01/host1:27018,host2:27018,host3:27018", "state": 1 }, { "_id": "shard02", "host": "shard02/host4:27018,host5:27018,host6:27018", "tags": [ "NYC" ], "state": 1 }, { "_id": "shard03", "host": "shard03/host7:27018,host8:27018,host9:27018", "state": 1 } ], "ok": 1, "$clusterTime" : { "clusterTime" : Timestamp(1510716515, 1), "signature" : { "hash" : BinData(0,"B2ViX7XLzFLS5Fl9XEuFXbwKIM4="), "keyId" : Long("6488045157173166092") } }, "operationTime" : Timestamp(1510716515, 1)}出力
listShards は、次の内容を含むドキュメントを返します。
それぞれが 1 つのシャードを説明するドキュメントの配列を含む
shardsフィールド。 各ドキュメントには、次のフィールドを含めることができます。フィールド説明_idシャードの名前。
hostシャードのホスト名。 シャードがレプリカセットの場合、
hostはレプリカセット内の各 mongod インスタンスのホスト名を一覧表示します。drainingtrue の場合、 は、このシャードに対して deleteShard（データベースコマンド）が呼び出され、ドレイン プロセス中であることを示します。
tagsシャードが属するゾーンのリスト。
state操作の
okステータス フィールド、operationTimeフィールド、$clusterTimeフィールド。 これらのフィールドの詳細については、「応答 」を参照してください。