文档中心

数据库传输服务

数据同步

修改同步对象

修改同步对象

DTS 支持变更数据同步任务中的同步对象。本文介绍如何通过控制台变更同步对象，并查看变更记录。

前提条件

状态执行中和同步失败且任务进入增量同步阶段的同步任务支持变更同步对象。同步任务的创建方法，请参见创建同步任务。

注意事项

仅在执行中且进入到增量同步阶段的 Redis、MySQL、PostgreSQL 和 MongoDB 类型的同步任务支持变更同步对象。

新增加的同步对象不支持修改同步类型，例如当前任务的同步类型未勾选结构初始化，那么您需确保目标端结构对象已存在，否则可能会影响新增对象的全量/增量同步，导致同步任务失败。

如果您创建的数据同步任务选择了全量同步，那么新增的对象会先将全量数据同步至目标端，再进行后续增量同步操作。

在修改同步对象时，不支持修改目标端已同步库表的名称。

配置同步延迟隔离时，不支持变更同步对象。更多关于同步延迟信息，请参见配置同步延迟隔离。

变更对象过程中，变更的对象不可以做 DDL 操作，否则可能会导致数据变更失败。

在双向同步任务中新增同步对象时，为避免因全量数据重复同步而导致数据不一致的情况发生，鉴于大部分业务场景是在源端新增库表，因此 DTS 的默认策略为：正向任务默认采用全量初始化 + 增量同步方式，反向任务默认仅进行增量同步。若您的业务场景是在目标端新增库表，则需先修改反向任务，对反向任务中新增的库表勾选全量初始化 + 增量同步，再修改正向任务，对正向任务中新增的库表仅勾选增量同步。

变更同步对象

在左侧导航栏，单击数据同步。

在同步任务列表页找到目标任务，单击任务进度右侧的配置。

在配置同步对象页面，配置如下参数。

参数			说明
冲突处理策略			选择当目标库已存在同主键值的行时的处理方法，取值如下：冲突覆盖：使用源库数据覆盖目标库数据，同步任务可正常启动。冲突忽略：预检查时会跳过对目标数据库中存在同主键值的行，同步任务可正常启动。注意冲突报错策略表示在任务运行时如果遇到目标库已存在的同主键或唯一值，则任务会报错并停止运行，报错信息中会提示冲突的数据。当前该策略属于加白功能，如需使用，请提交工单。若选择冲突忽略处理方法，可能导致数据不一致，给业务带来风险，请谨慎选择。如果同步对象有新增，那么新增的对象在增量同步启动前主键冲突处理策略都为冲突覆盖。
同步对象			选择需要同步的对象，如表格、视图、函数或存储过程等。
高级配置	开启 Key 过滤	在数据同步任务中，如果只需要同步符合条件的数据到目标数据库，通过 Key 过滤功能实现该目的。选择是否开启 Key 过滤功能。是：表示开启 Key 过滤功能。开启 Key 过滤后，需配置过滤规则。白名单：过滤规则选择白名单后，需输入正则表达式。表示通过该正则表达式匹配到的 Key 将被同步到目标端。黑名单：滤规则选择黑名单后，需输入正则表达式。表示通过该正则表达式匹配到的 Key 将被过滤，即不会同步到目标端。在开启 Key 过滤功能后，为了保证同步数据的准确性，单击在线测试，在 VolcDTSRedisKeyFilter 页面中，在线测试您输入的正则表达式是否完全满足您的过滤需求。根据测试结果，可以确认正则表达式是否语法正确，以及是否能够满足过滤需求，以降低数据同步中的数据丢失或同步错误风险。否：表示不开启 Key 过滤功能。
高级配置		同步偏好	按需选择同步偏好策略，支持以下选择：性能优先：可以提升存量数据同步的速率，但可能会增加磁盘碎片的空间占用，导致系统负载较高，建议目标端多预留 50% 的存储空间。性能优先适用于对存量数据同步速度要求较高的业务场景，例如金融交易、快速数据采集和实时监控等场景。空间优先：测试空间放大率一般在 5% 左右，适用于存储资源有限、对数据同步时效性要求相对较低的场景，例如数据归档、历史数据备份、日志文件同步等场景。

说明

在修改 Postgre SQL 同步对象时，无需配置冲突处理策略。

仅在修改 Redis 同步对象时，支持配置是否开启 Key 过滤功能。

仅在修改 MySQL 同步对象时，支持配置同步偏好。

在页面右下角，单击保存任务即可。

说明

变更同步对象后，您可以在控制台上查看变更记录详情。更多信息，请参见查看变更记录。

查看变更记录

登录 DTS 控制台。

在顶部菜单栏的左上角，选择目标地域。

在左侧导航栏，单击数据同步。

在同步任务列表页找到目标单向任务，单击任务进度右侧的更多操作 > 任务详情。

单击同步对象变更记录页签。

在变更记录表中，您可以查看变更对象的源和目标库表的名称、变更动作、变更时间和状态等信息。

说明

若变更记录较多，您可以在列表中根据变更动作和状态进行筛选查看。

同步对象变更发起后，在同步对象变更记录中为等待中状态，您需等待同步操作变更完成后，再进行下一步操作，当成功完成对象变更后，状态会变更为成功。

最近更新时间：2026.08.27 15:30:08

这个页面对您有帮助吗？

有用

有用

无用

无用