管理分片集群负载均衡器

检查负载均衡器状态

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

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

sh.getBalancerState()

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

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

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

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

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 mongoshshell 连接到集群中的任何 。

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 mongoshshell 连接到集群中的任何 。

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 不会中断进行中的迁移。

要禁用集合上的负载均衡，请使用mongos mongoshShell 连接到sh.disableBalancing() 并调用 方法。

例如：

sh.disableBalancing("students.grades")

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

对集合启用负载均衡

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

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

要启用集合负载均衡，请使用mongos mongoshShell 连接到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 }
)

更改给定分区的最大存储大小

更改分片的最大存储大小功能已被弃用。从版本 4.2 开始，MongoDB 使用 WiredTiger 存储引擎来管理数据的存储方式。WiredTiger 会压缩数据以尽量减少存储空间使用量。要了解详情，请参阅压缩。

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

从 6.2 版开始，MongoDB 删除了 addShard 命令中的 maxSize 字段。因此：

• 使用 maxSize 字段运行 addShard 会返回 InvalidOptions 错误。

• shards 集合中的新文件不再包含 maxSize 字段。

• 任何预先存在的 maxSize 字段条目都将被忽略。