balancerStop（データベースコマンド）

定義

balancerStop

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

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

MongoDB7.0 以降では、バランサーを停止すると、 シャーディングされたクラスターの AutoMerger も無効になります。

重要

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

Tip

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

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

互換性

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

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

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

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

構文

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

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

例

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

db.adminCommand( { balancerStop: 1 } )

詳細

• sh.stopBalancer()

• balancerStart