balancerStop
MongoDB5.0 已于 10 月2024 结束生命周期。不再支持此版本的文档。要升级5.0 部署,请参阅 MongoDB6 。0 升级程序。
定义
balancerStop
版本 3.4 中的新增功能。
禁用分片集群中的负载均衡器。 如果正在进行均衡轮次,则操作会等待均衡完成。
从MongoDB 4.2开始,该命令会禁用分片分片集群的自动分割。 要在禁用负载均衡器时启用自动分割,可以使用
sh.enableAutoSplit()
。您只能对
balancerStop
admin
实例上的 数据库发出mongos
。提示
在
mongosh
中,该命令也可通过sh.stopBalancer()
辅助方法运行。辅助方法对
mongosh
用户来说很方便,但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段,请使用数据库命令。在 6.1 之前的 MongoDB 版本中,该命令会禁用分片集群的自动分割。 要在禁用负载均衡器时启用自动分割,可以使用
sh.enableAutoSplit()
。
兼容性
此命令可用于以下环境中托管的部署:
MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务
重要
无服务器实例不支持此命令。 有关更多信息,请参阅不支持的命令。
MongoDB Enterprise:基于订阅、自我管理的 MongoDB 版本
MongoDB Community:源代码可用、免费使用且可自行管理的 MongoDB 版本
语法
您只能对balancerStop
admin
实例上的 数据库发出mongos
。
该命令采用以下形式:
db.adminCommand( { balancerStop: 1, maxTimeMS: <number> } )
字段 | 类型 | 说明 |
---|---|---|
| any | 任何值。 |
| 整型 |
例子
要停止负载均衡器线程,请连接到mongos
实例并发出以下命令:
db.adminCommand( { balancerStop: 1 } )