将自管理分片集群转换为副本集

本教程介绍如何将分片集群转换为非分片副本集。要将副本集转换为分片集群，请参阅将自管理副本集转换为分片集群。有关分片的集群的更多信息，请参阅分片文档。

本教程将指导您完成以下任务：

禁用负载均衡器。
将集群转换为副本集。
解锁集群（仅适用于多分片集群）。

开始之前

从MongoDB 8.0开始，您可以使用directShardOperations角色执行需要直接对分片执行命令的分片操作。

警告

使用 directShardOperations角色运行命令可能会导致集群停止正常工作，并可能导致数据损坏。仅将 directShardOperations角色用于维护目的或在MongoDB支持的指导下使用。执行完维护操作后，请停止使用 directShardOperations角色。

版本兼容性

本教程中的步骤需要MongoDB 6.0 或更高版本。

授权

fsync和fsyncUnlock 命令需要fsync 授权动作，可以通过hostManager 角色或自定义角色分配该操作。

安排集群转换

通常不执行数据块迁移、重新分片和模式转换时转换集群。

恢复为分片集群

从MongoDB 8.3 开始，之前分片的集群的副本集无法转换回分片的集群。

将分片集群转换为副本集时，会保留先前部署的分片元数据，包括分片身份document，以阻止其再次成为分片集群。如果您尝试将自管理转换回分片集群， MongoDB将返回错误。

要将此类副本集转换为分片的集群，联系技术支持。

步骤

对于只有一个分片的分片集群，该分片包含完整的数据集。要将该集群转换为非分片副本集：

禁用负载均衡器

要禁用负载均衡器：

将 mongosh 连接到分片集群中的 mongos实例。
要停止负载均衡器，运行：
sh.stopBalancer()
要验证负载均衡器是否已禁用，运行以下命令并确保输出为 false：
sh.getBalancerState()

将集群转换为副本集

停止所有 mongos 实例。
重新配置应用程序以直接连接将成为新副本集的分片的副本集节点。
mongod对副本集节点进行滚动重启，从 --shardsvr 中删除选项。
提示
更改 --shardsvr 选项会更改 mongod 监听入程连接的端口。

单分片集群现在是一个非分片副本集，可以接受针对数据集的读写操作。您可以根据需要停用配置服务器。

使用以下过程从具有多个分片的分片集群过渡到全新的副本集。

禁用负载均衡器并锁定集群

要禁用负载均衡器并锁集群：

将 mongosh 连接到分片集群中的 mongos实例。
要停止负载均衡器，运行：
sh.stopBalancer()
要验证负载均衡器是否已禁用，运行以下命令并确保输出为 false：
sh.getBalancerState()
要锁分片集群以防止数据库写入，运行：
db.getSiblingDB( "admin" ).fsyncLock()

要确认锁，运行：

db.getSiblingDB( "admin" ).aggregate( [
   { $currentOp: { } },
   { $facet: {
      "locked": [
         { $match: { $and: [
            { fsyncLock: { $exists: true } }
         ] } }
      ],
      "unlocked": [
         { $match: { fsyncLock: { $exists: false } } }
      ]
   } },
   { $project: {
      "fsyncLocked": { $gt: [ { $size: "$locked" }, 0 ] },
      "fsyncUnlocked": { $gt: [ { $size: "$unlocked" }, 0 ] }
   } }
] )

确保输出显示 fsyncLocked is true，这意味着集群已锁定：
[ { fsyncLocked: true }, { fsyncUnlocked: false } ]

将集群转换为副本集

锁定分片集群并禁用负载均衡器后，除了分片集群之外，还部署新的副本集。副本集必须有足够的容量来容纳当前所有组合分片的所有数据文件。在数据传输完成之前，请勿将应用程序配置为连接到新副本集。
重新配置应用程序或停止所有 mongos 实例。如果停止所有 mongos 实例，应用程序将无法从数据库中读取。如果停止所有 mongos 实例，则在应用程序无法访问的临时 mongos 实例上启动，以执行数据迁移步骤。
使用 mongodump 和 mongorestore 将数据从 mongos 实例迁移到新副本集。
运行mongorestore 时排除 config数据库。使用 --nsExclude 选项，如下示例所示：
mongorestore --nsExclude="config.*" <connection-string> /data/backup
注意
并非所有数据库上的所有集合都必须进行分片。不要仅迁移分片集合。确保所有数据库和所有集合均正确迁移。
将应用程序重新配置为使用非分片副本集，而不是 mongos 实例。
将分片集群转换为副本集后，将应用程序使用的连接字符串更新为副本集的连接字符串。然后，重新启动您的应用程序。

应用程序现在使用非分片的副本集进行读取和写入。您现在可以停用其余未使用的分片集群基础架。

解锁集群

将分片集群转换为副本集后，解锁集群：

要解锁集群并允许恢复数据库写入，运行：
db.getSiblingDB( "admin" ).fsyncUnlock()

要确认解锁，运行：

db.getSiblingDB( "admin" ).aggregate( [
   { $currentOp: { } },
   { $facet: {
      "locked": [
         { $match: { $and: [
            { fsyncLock: { $exists: true } }
         ] } } ],
         "unlocked": [
         { $match: { fsyncLock: { $exists: false } } }
      ]
   } },
   { $project: {
      "fsyncLocked": { $gt: [ { $size: "$locked" }, 0 ] },
      "fsyncUnlocked": { $gt: [ { $size: "$unlocked" }, 0 ] }
   } }
] )

确保输出显示 fsyncLocked is false，这意味着集群已解锁：
[ { fsyncLocked: false }, { fsyncUnlocked: true } ]

了解详情