sh.stopBalancer()

定义

sh.stopBalancer(timeout, interval)

在版本 6.1 中更改。

禁用分片集群中的负载均衡器。

从 MongoDB 6.0.3 开始，不再执行自动数据块分割。这是因为均衡策略的改进。自动分割命令仍然存在，但不执行操作。

在 6.0.3 之前的MongoDB版本中，sh.stopBalancer()还会禁用分片分片集群的自动分割。

重要

mongosh 方法

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

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

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

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

Parameter	类型	说明
timeout	整型	禁用负载均衡器的时间限制。 默认为 60000 毫秒。
interval	整型	检查均衡轮次是否已停止的时间间隔（以毫秒为单位）。

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

重要

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

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

mongosh shell方法是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()