balancerStatus

このバージョンのドキュメントはアーカイブされており、サポートされなくなりました。5.0 配置をアップグレードするには、 MongoDB 6.0 のアップグレード手順を参照してください。

定義

balancerStatus

バージョン 3.4 で追加。

バランサーの状態に関する情報を含むドキュメントを返します。

balancerStatus は adminデータベースに対してのみ発行できます。

mongoshでは、このコマンドは sh.isBalancerRunning()ヘルパーメソッドを通じて実行することもできます。

ヘルパーメソッドはmongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、データベースコマンドを使用します。

このコマンドは、次の環境でホストされている配置で使用できます。

このコマンドはサーバーレスインスタンスではサポートされていません。詳細については、「サポートされていないコマンド」を参照してください。

このコマンドの構文は、次のとおりです。

db.adminCommand( { balancerStatus: 1 } )

以下は、コマンドによって返されるドキュメントの例えです。

{
   "mode" : "full",
   "inBalancerRound" : false,
   "numBalancerRounds" : NumberLong(86),
   "ok" : 1
}

フィールド	説明
`"mode"`	バランサースレッドが実行中か停止かを指定する string。可能な値は次のとおりです。 " full" バランサースレッドは実行中ですが、必ずしもバランシングラウンドではありません。 "OFF" バランサースレッドが停止されます。このモードでは、チャンクのバランシングは実行できません。
`"inBalancerRound"`	バランサーがバランシングラウンド内かどうかを指定するブール値。 `inBalancerRound=true`の場合、チャンクが分散されます。 `inBalancerRound` `true`は、の場合は`mode=off` になります。バランサーラウンド中にバランサーの電源を切ると、サーバーは中断するのではなくバランサーを完了させます。
`"numBalancerRounds"`	コンフィギュレーションサーバーが起動されて以降に発生したバランサーラウンドの数。この値は保持されず、コンフィギュレーションサーバーの再起動時に 0 にリセットされます。

mongosインスタンスに接続し、次のコマンドを発行します。

db.adminCommand( { balancerStatus: 1 } )

戻る

balancerStart

balancerStop