balancerStop

定義

balancerStop

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

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

重要

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

Tip

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

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

MongoDB 6.0.3以降、 自動チャンク分割は実行されません。 これはバランシング ポリシーの改善によるものです。 自動分割コマンドは引き続き存在しますが、操作は実行されません。

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

互換性

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

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

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

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

構文

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

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

例

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

db.adminCommand( { balancerStop: 1 } )

詳細

• sh.stopBalancer()

• balancerStart