replSetSyncFrom（数据库命令）

说明

replSetSyncFrom

暂时覆盖当前mongod的默认同步目标。此操作对于测试不同模式以及集成员未从所需主机复制的情况非常有用。

提示

在 mongosh 中，该命令也可以通过 rs.syncFrom() 辅助方法运行。

助手方法对于 mongosh 用户来说很方便，但它们可能返回与数据库命令不同级别的信息。如果不追求方便或需要额外的返回字段，请使用数据库命令。

在 admin数据库中运行 replSetSyncFrom。

兼容性

此命令可用于以下环境中托管的部署：

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

重要

MongoDB Atlas集群不支持此命令。有关Atlas支持所有命令的信息，请参阅不支持的命令。

语法

该命令具有以下语法：

db.adminCommand(
   {
     replSetSyncFrom: "hostname<:port>"
   }
 )

命令字段

该命令采用以下字段：

字段	类型	说明
`replSetSyncFrom`	字符串	该成员应从中进行复制的副本集成员的名称和端口号。使用`[hostname]:[port]`表单。副本集`1 vote`节点无法从`0 votes`节点同步。

行为

限制

要使 replSetSyncFrom 覆盖默认同步目标，settings.chainingAllowed 必须设立为 true。

如果 settings.chainingAllowed设立为 false，replSetSyncFrom 会返回ok:1，但不会设立同步目标。

从MongoDB 5.0.2 开始，您可以通过将服务器参数 enableOverrideClusterChainingSetting 设置为 true 来覆盖 settings.chainingAllowed。即使 settings.chainingAllowed 为 false，这也允许从辅助节点成员进行同步。

同步逻辑

如果在运行replSetSyncFrom 时正在进行初始同步操作，replSetSyncFrom 则会停止进行中的初始同步，并使用新目标重新启动同步进程。

仅根据需要修改默认同步逻辑，并且始终谨慎操作。

目标

要同步的节点必须是数据集中数据的有效来源。如需从节点同步，节点必须：

有数据。在启动或恢复模式下不能是仲裁节点，必须能够响应数据查询。
可访问。
在副本集配置中是同一集的成员。
使用 members[n].buildIndexes 设置构建索引。
集合中的另一个成员，以防止与自身同步。

如果尝试从落后当前节点 10 秒以上的节点复制，mongod 将记录警告，但仍会从落后的节点复制。另请参阅“复制延迟和流量控制”。

持久性

replSetSyncFrom 提供对默认行为的临时覆盖。在以下情况下，mongod 将恢复为默认同步行为：

mongod 实例将重新启动。
mongod 与同步目标之间的连接将关闭。
如果同步目标落后副本集其他成员超过 maxSyncSourceLagSecs（默认30）秒。

有关使用 replSetSyncFrom 的更多信息，请参阅配置自管理从节点的同步目标。