sh.stopBalancer()（mongoshメソッド）

定義

sh.stopBalancer(timeout, interval)

バージョン7.0で変更。

シャーディングされたクラスター内のバランサーを無効にします。

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

重要

mongosh メソッド

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

データベースコマンドについては、balancerStop コマンドを参照してください。

MongoDB API ドライバーについては、各言語の「MongoDB ドライバーのドキュメント」を参照してください。

メソッドは次のオプションを取ることができます。

Parameter	タイプ	説明
timeout	integer	バランサーを無効にする時間制限。 デフォルトは 60000 ミリ秒です。
interval	integer	バランシング ラウンドが停止したかどうかを確認する間隔（ミリ秒単位）。

両方のオプションを省略すると、MongoDB はバランサーを無期限に無効にします。

重要

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

You can only run sh.stopBalancer() on a mongos instance. sh.stopBalancer() errors if run on mongod instance.

The mongosh shell method is a wrapper around the balancerStop command.

互換性

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

• MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです

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

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

動作

バランシング ラウンドが進行中の場合、 操作はバランシングが完了するまで待機します。

詳細

• sh.enableBalancing()

• sh.disableBalancing()

• sh.getBalancerState()

• sh.isBalancerRunning()

• sh.setBalancerState()

• sh.startBalancer()

• sh.waitForBalancer()

• sh.waitForBalancerOff()