balancerStop（数据库命令）

定义

balancerStop

禁用分片集群中的负载均衡器。 如果正在进行均衡轮次，则操作会等待均衡完成。

您只能对balancerStop admin实例上的 数据库发出mongos 命令。

从MongoDB7.0 开始，停止负载均衡器还会禁用分片集群的 AutoMerger。

重要

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

提示

在 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