定義
sh.shardDrainingStatus(shardId)バランサーがまだチャンクをクラスター内の他のシャードに移動しているか、プロセスが完了しているかにかかわらず、ドレインシャードのステータスを表示します。
バージョン9.0の新機能。
shardIdを指定しない場合、このメソッドは現在ドレイン中のすべてのシャードのステータスを返します。重要
mongosh メソッド
このページでは、
mongoshメソッドについて記載しています。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。データベースコマンドについては、
shardDrainingStatusコマンドを参照してください。MongoDB API ドライバーについては、各言語の MongoDB ドライバー ドキュメントを参照してください。
互換性
このメソッドは、次の環境でホストされている配置で使用できます。
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
注意
このコマンドはMongoDB Atlasではサポートされていません。Atlas クラスターからシャードを追加または削除するには、「Atlasシャードクラスタの変更」を参照してください。
構文
sh.shardDrainingStatus( <shardId> )パラメーター
Parameter | タイプ | 説明 |
|---|---|---|
| string | 任意。レポート対象のドレイン中のシャードの名前。省略した場合、このメソッドはすべてのドレイン中のシャードについてレポートします。 |
出力フィールド
出力フィールドについては、shardDrainingStatusコマンドを参照してください。
動作
アクセス要件
authorizationを有効にしている場合は、 clusterManagerロールまたはremoveShardアクションを含む任意のロールが必要です。
データベース移行要件
シャーディングされたクラスター内の各データベースにはプライマリシャードがあります。ドレインするシャードが、クラスターのデータベースの 1 つのプライマリでもある場合は、シャードからすべてのデータを移行した後、データベースを新しいシャードに手動で移動する必要があります。See the movePrimary command and the シャードからクラスターを削除する for more information.
コレクション移行要件
シャーディングされていないコレクションは、個々のシャードに保存されます。これらのコレクションの 1 つが除くシャード上にある場合は、まずそのコレクションを別のシャードに移行する必要があります。
シャーディングされていないコレクションを移行するには、moveCollection コマンドをご覧ください。
例
次の例では、shard04 シャードのドレインステータスを返します。
sh.shardDrainingStatus( "shard04" ){ msg: "draining ongoing", state: "ongoing", remaining: { chunks: Long(2), dbs: Long(2), jumboChunks: Long(0), collectionsToMove: Long(2) }, shard: "shard04", note: "you need to call moveCollection for collectionsToMove and afterwards movePrimary for the dbsToMove", dbsToMove: [ "fizz", "buzz" ], collectionsToMove: [ "fizz.coll1", "buzz.coll1" ], ok: 1, operationTime: Timestamp(1575399086, 1655), $clusterTime: { clusterTime: Timestamp(1575399086, 1655), signature: { hash: BinData(0,"XBrTmjMMe82fUtVLRm13GBVtRE8="), keyId: Long("6766255701040824328") } }}