文档菜单
文档首页
/
MongoDB 手册
/ / /

balancerStatus

在本页面上

  • 定义
  • 兼容性
  • 语法
  • 输出文档
  • 示例
balancerStatus

返回一个包含平衡器状态的文档。

只能对admin数据库发出balancerStatus命令。

提示

mongosh中,此命令也可以通过sh.isBalancerRunning()辅助方法运行.

辅助方法对 mongosh 用户来说很方便,但它们可能不会返回与数据库命令相同级别的信息。在不需要便利性或需要额外返回字段的情况下,请使用数据库命令。

此命令在以下环境中可用的部署中可用

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

重要

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

此命令的语法如下

db.adminCommand(
{
balancerStatus: 1
}
)

以下是该命令返回的文档示例

{
"mode" : "full",
"inBalancerRound" : false,
"numBalancerRounds" : NumberLong(86),
"ok" : 1
}
字段
描述
"mode"

指定均衡器线程是正在运行还是已停止的字符串。可能的值是

  • "full"
    平衡线程正在运行,但不一定处于平衡循环中。
  • "关闭"
    平衡线程已停止。在此模式下无法进行块平衡。
"inBalancerRound"

一个布尔值,用于指定平衡器是否处于平衡循环中。如果inBalancerRound=true,它现在正在分配块。

inBalancerRound可以在mode=关闭时为true。如果您在平衡循环中关闭平衡器,服务器将允许其完成而不是中断它。

"numBalancerRounds"
自配置服务器启动以来发生的平衡循环次数。此值不会被持久化,并在配置服务器重新启动时重置为0。

连接到mongos实例并执行以下命令

db.adminCommand( { balancerStatus: 1 } )

返回

balancerStart