balancerStop

定義

balancerStop

バージョン 3.4 で追加。

シャーディングされたクラスター内のバランサーを無効にします。 バランシング ラウンドが進行中の場合、 操作はバランシングが完了するまで待機します。

MongoDB 4.2以降では、 コマンドはシャーディングされたクラスターの自動分割を無効にします。 バランサーが無効になっているときに自動分割を有効にするには、 sh.enableAutoSplit()を使用できます。

balancerStopインスタンス上のadmin データベースに対してのみmongos を発行できます。

重要

バランサーを長期間無効のままにすると、シャードのバランスが取れず、クラスターのパフォーマンスが低下する可能性があります。 必要な場合のみバランサーを無効にし、メンテナンスが完了した後にバランサーを再度有効にするようにします。

Tip

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

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

MongoDB バージョン 6.1 より前では、 コマンドはシャーディングされたクラスターの自動分割を無効にします。 バランサーが無効になっているときに自動分割を有効にするには、 sh.enableAutoSplit()を使用できます。

互換性

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

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

balancerStopインスタンス上のadmin データベースに対してのみmongos を発行できます。

コマンドは、次の形式をとります。

db.adminCommand( { balancerStop: 1, maxTimeMS: <number> } )

例

バランサー スレッドを停止するには、 mongosインスタンスに接続して次のコマンドを実行します。

db.adminCommand( { balancerStop: 1 } )

詳細

• sh.stopBalancer()

• balancerStart