管理分片集群均衡器

检查均衡器状态

sh.getBalancerState() 检查均衡器是否启用（即均衡器是否被允许运行）。sh.getBalancerState() 不检查均衡器是否正在迁移数据。

要查看您的 分片集群 中是否启用了均衡器，请运行以下命令，该命令返回一个布尔值

sh.getBalancerState()

您还可以使用 sh.status() 查看是否启用了均衡器。字段 currently-enabled 表示均衡器是否启用，而字段 currently-running 表示均衡器是否当前正在运行。

检查均衡器是否正在运行

要查看您的集群中均衡器进程是否活跃：

1. 使用mongosh壳

2. 使用以下操作来确定均衡器是否正在运行

   sh.isBalancerRunning()

配置默认范围大小

分片集群的默认范围大小为128兆字节。在大多数情况下，默认大小适用于分割和迁移数据块。有关范围大小如何影响部署的信息，请参阅范围大小。

更改默认范围大小会影响迁移和自动分割过程中处理的范围，但不会对所有范围产生追溯影响。

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

要配置默认范围大小，请参阅在分片集群中修改数据块大小。

安排平衡窗口

在某些情况下，尤其是当你的数据集缓慢增长且迁移可能会影响性能时，确保平衡器只在特定时间激活是有用的。默认情况下，平衡器进程始终启用并迁移块。以下过程指定了 activeWindow，这是平衡器可以迁移块的时段。

use config

sh.startBalancer()

db.settings.updateOne(
   { _id: "balancer" },
   { $set: { activeWindow : { start : "<start-time>", stop : "<stop-time>" } } },
   { upsert: true }
)

检查均衡窗口

要查看当前均衡窗口，请运行以下命令

use config
db.settings.find( { _id: "balancer" } )

删除均衡窗口计划

如果您已经设置了均衡窗口并希望删除计划，以便均衡器始终运行，请使用$unset来清除activeWindow，如下所示

use config
db.settings.updateOne( { _id : "balancer" }, { $unset : { activeWindow : true } } )

禁用均衡器

默认情况下，均衡器可以在任何时候运行，并且仅在需要时移动数据块。要暂时禁用均衡器并防止所有迁移，请使用以下程序

1. 使用mongos集群中的任意一个mongosh shell连接。

2. 执行以下操作以禁用均衡器

   sh.stopBalancer()

   如果正在进行迁移，系统将在停止之前完成正在进行的迁移。

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

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

3. 要验证均衡器不会启动，请运行以下命令，如果均衡器已禁用，则返回false

   sh.getBalancerState()

   可选地，为了验证禁用后没有正在进行的迁移，请在mongosh shell中执行以下操作

   use config
   while( sh.isBalancerRunning() ) {
             print("waiting...");
             sleep(1000);
   }

db.adminCommand( { balancerStop: 1 } )

启用均衡器

如果您已禁用均衡器并准备好重新启用它，请使用此程序

1. 使用mongos集群中的任意一个mongosh shell连接。

2. 执行以下任一操作以启用均衡器

   从mongosh shell中，执行

   sh.startBalancer()

   注意

   要使用驱动程序启用均衡器，请在admin数据库上使用balancerStart命令，如下所示

   db.adminCommand( { balancerStart: 1 } )

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

   在MongoDB 6.0.3之前的版本中，sh.startBalancer()还启用了分片集群的自动拆分。

在备份期间禁用均衡器

如果在备份期间MongoDB迁移了一个数据块，您可能会得到一个不一致的分片集群快照。在均衡器活动时，永远不要运行备份。为确保在备份操作期间均衡器处于非活动状态

• 设置均衡窗口，使均衡器在备份期间处于非活动状态。确保在禁用均衡器的情况下备份可以完成。

• 手动禁用均衡器以备份过程的时间。

如果均衡器在均衡轮次中间关闭，关闭操作不是瞬时的。均衡器完成正在进行的块移动，然后停止所有进一步的均衡轮次。

在开始备份操作之前，请确认均衡器不是活动的。您可以使用以下命令来确定均衡器是否活动

!sh.getBalancerState() && !sh.isBalancerRunning()

当备份过程完成时，您可以重新激活均衡器过程。

在集合上禁用均衡

您可以使用sh.disableBalancing()方法禁用特定集合的均衡。您可能需要禁用特定集合的均衡器以支持维护操作或非典型工作负载，例如，在数据导入或数据导出期间。

当您在集合上禁用均衡时，MongoDB不会中断正在进行中的迁移。

要禁用集合上的均衡，使用mongos与mongosh shell，并调用sh.disableBalancing()方法。

例如

sh.disableBalancing("students.grades")

sh.disableBalancing()方法接受作为其参数的集合的完整命名空间。

在集合上启用均衡

您可以使用 sh.enableBalancing() 方法为特定集合启用均衡。

当您为集合启用均衡时，MongoDB 不会立即开始均衡数据。但是，如果您的分片集合中的数据不平衡，MongoDB 将能够开始更均匀地分发数据。

要为集合启用均衡，请使用 mongosh shell 连接到 mongos 并调用 sh.enableBalancing() 方法。

例如

sh.enableBalancing("students.grades")

sh.enableBalancing() 方法接受集合的完整 命名空间 作为其参数。

确认均衡是否启用或禁用

要确认集合的均衡是否启用或禁用，请在 config 数据库中查询 collections 集合以获取集合的 命名空间，并检查 noBalance 字段。例如

db.getSiblingDB("config").collections.findOne({_id : "students.grades"}).noBalance;

此操作将返回空错误、true、false 或无输出

• 空错误表示集合命名空间不正确。

• 如果结果为 true，则均衡已禁用。

• 如果结果为 false，则当前均衡已启用但以前已为该集合禁用。下一次均衡器运行时将开始此集合的均衡。

• 如果操作没有返回输出，当前集合已启用均衡且从未被禁用。下一次均衡器运行时，将开始此集合的均衡。

您还可以使用 sh.status() 来查看均衡器是否启用。字段 currently-enabled 表示均衡器是否启用。

更改数据块迁移的复制行为

use config
db.settings.updateOne(
   { "_id" : "balancer" },
   { $set : { "_secondaryThrottle" : { "w": "majority" }  } },
   { upsert : true }
)

db.getSiblingDB("config").settings.updateOne(
   { _id: "balancer" },
   { $set: { attemptToBalanceJumboChunks : true } },
   { upsert: true }
)

更改特定分片的最大存储大小

对于 MongoDB 6.1 及更早版本，您仍然可以通过使用 maxSize 字段来设置分片在分片集群中的最大存储大小。您可以在 config.shards 集合中找到有关分片的相关配置数据。

从版本 6.2 开始，MongoDB 从 addShard 命令中删除了 maxSize 字段。

• 因此，使用带有 maxSize 字段的 addShard 运行会返回一个 InvalidOptions 错误。

• 在 shards 集合中创建的新文档不再包含 maxSize 字段。

• 任何现有的 maxSize 字段条目都将被忽略。