sh.stopBalancer()

定义

sh.stopBalancer(timeout, interval)

版本 4.2 中进行了更改。

禁用分片集群中的负载均衡器。 从 MongoDB 4.2开始， sh.stopBalancer()还禁用分片集群的自动分割。

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序（例如 Node.js）的相关文档。

有关数据库命令，请参阅 balancerStop 命令。

如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

该方法可以采用以下选项：

Parameter	类型	说明
timeout	整型	禁用负载均衡器的时间限制。 默认为 60000 毫秒。 在 3.4 版中进行了更改：如果将 3.4 mongo shell 与早期版本的分片集群一起使用，该参数将指定等待平衡轮次停止的毫秒数。
interval	整型	检查均衡轮次是否已停止的时间间隔（以毫秒为单位）。

如果省略这两个选项，MongoDB 将无限期禁用负载均衡器。

重要

长时间禁用负载负载均衡器可能会导致分片失衡，从而降低集群性能。 仅在必要时禁用负载均衡器，并确保在维护完成后重新启用负载均衡器。

您只能在 实例上运行sh.stopBalancer() mongos。sh.stopBalancer()如果在mongod 实例上运行，则会出现 错误。

mongo Shell 方法是 3.4 中引入的balancerStop命令的包装器。

兼容性

此方法可用于以下环境中托管的部署：

• 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()