Docs 菜单
Docs 主页
/
MongoDB Manual
/ / /

balancerStop

在此页面上

  • 定义
  • 兼容性
  • 语法
  • 例子
  • 了解详情
balancerStop

版本 3.4 中的新增功能

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

从MongoDB 4.2开始,该命令会禁用分片分片集群的自动分割。 要在禁用负载均衡器时启用自动分割,可以使用 sh.enableAutoSplit()

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

重要

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

提示

mongosh 中,该命令也可通过 sh.stopBalancer() 辅助方法运行。

辅助方法对 mongosh 用户来说很方便,但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段,请使用数据库命令。

在 6.1 之前的 MongoDB 版本中,该命令会禁用分片集群的自动分割。 要在禁用负载均衡器时启用自动分割,可以使用sh.enableAutoSplit()

此命令可用于以下环境中托管的部署:

  • MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务

重要

无服务器实例不支持此命令。 有关更多信息,请参阅不支持的命令。

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

该命令采用以下形式:

db.adminCommand( { balancerStop: 1, maxTimeMS: <number> } )
字段
类型
说明

balancerStop

any

任何值。

maxTimeMS

整型

禁用负载均衡器的时间限制。

默认为 60000 毫秒。

在 3.4 版中进行了更改:如果将 3.4 mongo shell 与早期版本的分片集群一起使用,该参数将指定等待平衡轮次停止的毫秒数。

要停止负载均衡器线程,请连接到mongos实例并发出以下命令:

db.adminCommand( { balancerStop: 1 } )

后退

balancerStatus