管理分片集群负载均衡器

检查负载均衡器状态

sh.getBalancerState() 会检查是否已启用负载均衡器（即，允许负载均衡器运行）。sh.getBalancerState() 不会检查负载均衡器是否正在主动迁移数据。

如要查看您的分片集群中是否已启用负载均衡器，请运行以下命令（会返回一个布尔值）：

sh.getBalancerState()

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

检查负载均衡器是否正在运行

要查看集群中的负载均衡器进程是否处于活动状态：

1. 使用 mongosh shell 连接集群中的任何 mongos。

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

   sh.isBalancerRunning()

配置默认范围大小

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

更改默认范围大小会影响迁移和自动分割期间所处理的范围，但不会以追溯方式影响所有范围。

从 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 shell 连接到集群中的任意 mongosh。

2. 发出以下操作以禁用负载均衡器：

   sh.stopBalancer()

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

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

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

3. 要确保负载均衡器不会启动，请运行以下命令。如果负载均衡器已被禁用，此命令则会返回 false：

   sh.getBalancerState()

   或者，要验证在禁用后没有进行中的迁移，请在 mongosh Shell 中运行以下操作：

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

db.adminCommand( { balancerStop: 1 } )

启用负载均衡器

如果已禁用负载均衡器并准备重新启用它，请执行以下过程：

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

2. 发出以下操作之一以启用负载均衡器：

   在 mongosh shell 中，发出以下命令：

   sh.startBalancer()

   注意

   要从驱动程序启用负载均衡器，请对 admin 数据库使用 balancerStart 命令，如下所示：

   db.adminCommand( { balancerStart: 1 } )

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

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

在备份期间禁用负载均衡

如果 MongoDB 在备份期间迁移数据段，则最后可能导致不一致的分片集群快照。切勿在负载均衡器处于活动状态时运行备份。要确保负载均衡器在备份操作期间处于非活动状态，请执行以下操作：

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

• 在备份过程期间手动禁用负载均衡器。

如果在某一负载均衡回合中关闭负载均衡器，则不会立即将其关闭。负载均衡器会先完成进行中的数据段移动，然后再停止所有后续负载均衡回合。

在开始备份操作之前，请确认负载均衡器未处于活动状态。您可以使用以下命令来确定负载均衡器是否处于活动状态：

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

备份过程完成后，您可以重新激活负载均衡器进程。

对集合禁用负载均衡

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

对集合禁用负载均衡时，MongoDB 不会中断进行中的迁移。

要对集合禁用负载均衡，请使用 mongoshshell 连接到 mongos 并调用 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;

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

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

• 如果结果为 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 字段条目都将被忽略。