暂停或终止同步

在此页面上

Realm 现已更名为 Atlas Device SDK – 了解详情

若要为您的应用禁用 Atlas Device Sync，您可以暂时停止或永久终止同步。您也可以在禁用 Device Sync 后重新启用同步。

如果需要暂停集群，可以暂时暂停Device Sync。暂停后，您可以重新启用，而不会重置Device Sync 配置或丢失 Device Sync 元数据。

出于故障排除或想要更改 Device Sync 配置，您可以永久终止并重新启用 Device Sync。

设备同步在 30 天未活动后自动暂停。

暂停同步

您可以将 Device Sync 暂停一段时间，而无需完全禁用。当暂停 Device Sync 时，Atlas 和应用程序之间的数据更改将停止同步。

如果需要暂停集群，请先暂停 Device Sync。否则，您必须终止并重新启用Device Sync，并执行客户端重置。

暂停 Device Sync 会拒绝任何传入的客户端连接。这意味着暂停应用的 Device Sync 会停止同步所有客户端的更改。

暂停 Device Sync 后，您可以重新启用它。暂停 Device Sync 会保留配置设置和所有 Device Sync 元数据，其中包含同步历史记录。当您重新启用已暂停的 Device Sync 时，您的客户端可以正常重新连接。

如果您的oplog滚动超过您暂停 Device Sync 的时间，您必须终止并重新启用 Device Sync。例如，如果您只为集群保留12小时的 oplog，并且暂停 Device Sync 的时间超过12小时，则必须终止并重新启用 Device Sync。

为应用终止并重新启用已暂停的 Atlas Device Sync 会清除 Atlas Device Sync 元数据，并要求您再次指定配置设置。 Atlas Device Sync 终止后，客户端在重新连接时必须执行客户端重置。有关更多信息，请参阅：终止同步。

如果您已启用 Device Sync ，则在几种不同情况下可能必须终止并重新启用 Device Sync：

从共享层级 Atlas 集群升级到共享实例或专用实例
迁移到跨地区/云提供商分布的 Atlas 集群
升级到 NVMe Atlas 集群
oplog 轮转
由于不频繁使用，共享层级集群上的 Device Sync 同步会话暂停
应 MongoDB 支持部门的要求进行故障排除
在同步模式之间切换。实例，如果要从基于分区的同步切换到 Flexible Sync
删除您在同步中使用过的collection。例如，如果您有一个存储和同步Team Team对象的collection，然后删除该collection，则必须终止并重新启用 Sync。

当您终止并重新启用 Atlas Device Sync 时，客户端将无法再同步。您的客户端必须执行客户端重置处理程序才能恢复同步。此处理程序可以放弃或尝试恢复未同步的更改。

终止 Device Sync 后，您可以重新启用它。终止 Device Sync 会破坏配置设置和所有 Device Sync 元数据，其中包含同步历史记录。重新启用同步需要您再次完成同步配置步骤。之前已连接的客户端在执行客户端重置之前无法重新连接。

暂停或终止 Device Sync 后，您可以重新启用同步。重新启用 Device Sync 会让您的应用再次开始将更改同步到 Atlas。重新启用 Device Sync 后，您的应用再次开始接受传入的客户端连接。

重新启用同步可启用传入客户端连接。但是，在某些情况下，客户端应用代码可能需要执行客户端重置，客户端才能再次同步。

如果客户端之前已与 Device Sync 连接，然后您终止 Device Sync，那么您的代码必须处理客户端重置。终止应用的 Device Sync 会删除客户端重新连接所需要的 Device Sync 元数据。

这也适用于 Device Sync 暂停时间超过您为集群保留的oplog的应用程序。例如，如果您只为集群保留12小时的 oplog，并且暂停 Device Sync 的时间超过12小时，则必须终止并重新启用 Device Sync。

有关如何在客户端中执行客户端重置的信息，请参阅 SDK 文档：