管理分片集群负载均衡器

检查负载均衡器状态

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

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

sh.getBalancerState()

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

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

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

1. Connect to any mongos in the cluster using the mongosh shell.

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

   sh.isBalancerRunning()

配置默认范围大小

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

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

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

安排均衡窗口

某些情况下，尤其是当数据集增长缓慢且迁移可能会影响性能时，确保负载均衡器仅在特定时间处于活动状态非常有用。默认情况下，负载均衡器进程始终处于启用状态并会迁移数据块。以下过程指定了 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" } )

移除负载均衡窗口时间表

If you have set the balancing window and wish to remove the schedule so that the balancer is always running, use $unset to clear the activeWindow, as in the following:

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

禁用负载均衡器

默认情况下，负载均衡器可随时运行，且仅按需移动数据段。要在一小短时间内禁用负载均衡器并阻止所有迁移，请执行以下过程：

1. Connect to any mongos in the cluster using the mongosh shell.

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

   sh.stopBalancer()

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

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

   sh.getBalancerState()

   Optionally, to verify no migrations are in progress after disabling, run the following operation in the mongosh shell:

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

db.adminCommand( { balancerStop: 1 } )

从MongoDB 7.0 开始，停止负载均衡器还会禁用分片集群的 AutoMerger。

启用负载均衡器

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

1. Connect to any mongos in the cluster using the mongosh shell.

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

   From the mongosh shell, issue:

   sh.startBalancer()

   注意

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

   db.adminCommand( { balancerStart: 1 } )

从MongoDB 7.0 开始，启动负载均衡器还会为分片集群启用 AutoMerger。

在备份期间禁用负载均衡

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

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

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

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

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

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

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

对集合禁用负载均衡

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

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

To disable balancing on a collection, connect to a mongos with the mongosh shell and call the sh.disableBalancing() method.

例如：

sh.disableBalancing("students.grades")

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

对集合启用负载均衡

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

为集合启用负载均衡后，MongoDB 不会立即开始对数据进行负载均衡。但是，如果分片集合中的数据未进行负载均衡，MongoDB 可以开始更均匀地分发该数据。

To enable balancing on a collection, connect to a mongos with the mongosh shell and call the sh.enableBalancing() method.

例如：

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 }
)