如果同步的源数据库类型为MySQL，如自建MySQL、RDS MySQL，您需要在配置具体的同步任务前，参考本文的注意事项及限制，以保障数据同步任务的正常运行。

源库为MySQL的同步方案概览

根据如下同步方案，查看同步任务的注意事项及限制：

说明 请您仔细阅读注意事项及限制后再配置同步任务。具体配置文档，请参见DTS数据同步方案概览。

MySQL间的同步

如果同步的目标数据库类型为MySQL，如RDS MySQL、自建MySQL，具体注意事项及限制如下：

类型 说明
源库限制
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
其他限制
  • 建议源和目标库的MySQL版本保持一致，以保障兼容性。
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。
特殊情况
  • 当源库为自建MySQL时
    • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
    • 由于DTS的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
      说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。
  • RDS MySQL实例间的双向同步
    • 目前DTS仅支持两个MySQL数据库之间的双向同步，暂不支持多个MySQL数据库之间的双向同步。
    • DDL语法同步方向限制 。为保障双向同步链路的稳定性，只支持正向同步DDL，不支持反向同步DDL。

MySQL同步至PolarDB MySQL

如果同步的目标数据库类型为PolarDB MySQL，具体注意事项及限制如下：

类型 说明
源库限制
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
其他限制
  • 建议源和目标库的MySQL版本保持一致，以保障兼容性。
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。
特殊情况
  • 当源库为自建MySQL时
    • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
    • 由于DTS的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
      说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。
  • PolarDB MySQL集群间的双向同步
    • 目前DTS仅支持两个MySQL数据库之间的双向同步，暂不支持多个MySQL数据库之间的双向同步。
    • DDL语法同步方向限制 。为保障双向同步链路的稳定性，只支持正向同步DDL，不支持反向同步DDL。

MySQL同步至云原生数据仓库AnalyticDB MySQL

如果同步的目标数据库类型为云原生数据仓库AnalyticDB MySQL，具体注意事项及限制如下：

类型 说明
源库限制
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
其他限制
  • 暂不支持同步前缀索引，如果源库存在前缀索引可能导致数据同步失败。
  • 如果同步的目标为云原生数据仓库AnalyticDB MySQL（2.0），那么源实例待同步的对象不能包含云原生数据仓库AnalyticDB MySQL（2.0）保留的库名和列名，否则将造成数据同步失败或DDL操作同步失败。
  • 由于云原生数据仓库AnalyticDB MySQL（3.0）本身的使用限制，当云原生数据仓库AnalyticDB MySQL（3.0）集群中的节点磁盘空间使用量超过80%，会导致DTS任务异常，产生延迟。请提前根据待同步的对象预估所需空间，确保目标集群具备充足的存储空间。
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
特殊情况 当源库为自建MySQL时
  • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
  • 由于DTS的延迟时间是根据同步的最新数据时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
    说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。

MySQL同步至云原生数据仓库AnalyticDB PostgreSQL

如果同步的目标数据库类型为云原生数据仓库AnalyticDB PostgreSQL，具体注意事项及限制如下：

类型 说明
源库限制
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
其他限制
  • 暂不支持同步前缀索引，如果源库存在前缀索引可能导致数据同步失败。
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。
特殊情况 当源库为自建MySQL时
  • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
  • 由于DTS的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
    说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。

MYSQL同步至DataHub

如果同步的目标数据库类型为DataHub，具体注意事项及限制如下：

类型 说明
源库限制
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
其他限制
  • 不支持全量数据初始化，即DTS不会将源RDS实例中同步对象的存量数据同步至目标DataHub实例。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。

MySQL同步至Elasticsearch

如果同步的目标数据库类型为Elasticsearch，具体注意事项及限制如下：

类型 说明
源库限制
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
其他限制
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。
  • 如果源库中待同步的表需要执行增加列的操作，您只需先在Elasticsearch实例中修改对应表的mapping，然后在源MySQL数据库中执行相应的DDL操作，最后暂停并启动DTS同步实例。
特殊情况 当源库为自建MySQL时
  • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
  • 由于DTS的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
    说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。

MySQL同步至MaxCompute

如果同步的目标数据库类型为MaxCompute，具体注意事项及限制如下：

类型 说明
源库限制
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
其他限制
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。
  • 由于MaxCompute不支持主键约束，当DTS在同步数据时因网络等原因触发重传，可能会导致MaxCompute中出现重复记录。
特殊情况 当源库为自建MySQL时
  • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
  • 由于DTS的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
    说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。

MySQL同步至ClickHouse集群

如果同步的目标数据库类型为ClickHouse集群，具体注意事项及限制如下：

类型 说明
源库限制
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
注意事项
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。
  • 待同步数据库、表和列的名称符合云数据库ClickHouse的命名规范，相关规范请参见对象命名规范限制。
特殊情况 当源库为自建MySQL时
  • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
  • 由于DTS的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
    说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。

MySQL同步至Tablestore

如果同步的目标数据库类型为Tablestore，具体注意事项及限制如下：

类型 说明
源库限制
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
其他限制
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。
  • 待同步的表或列名称符合Tablestore实例的命名规范：
    • 表或列的名称由大小写字母、数字或下划线（_）组成，且只能以字母或下划线开头。
    • 表或列的名称长度为1~255个字符。
特殊情况 当源库为自建MySQL时
  • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
  • 由于DTS的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
    说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。

MySQL同步至阿里云消息队列Kafka版、自建Kafka集群

如果同步的目标数据库类型为阿里云消息队列Kafka版、自建Kafka集群，具体注意事项及限制如下：

类型 说明
源库的环境要求
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
注意事项
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。
特殊情况 当源库为自建MySQL时
  • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
  • 由于DTS的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
    说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。

MySQL同步至PolarDB-X

如果同步的目标数据库类型为PolarDB-X，具体注意事项及限制如下：

类型 说明
源库的环境要求
  • 待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。
  • Binlog日志：
    • 需开启，并且binlog_format为row、binlog_row_image为full。否则预检查阶段显示报错提示，且无法成功启动数据同步任务。
    • 至少保留24小时（建议3天以上）。否则当链路由于不可控因素中断，可能由于Binlog的缺失导致链路无法恢复。
注意事项
  • MySQL同步至PolarDB-X暂不支持结构初始化，在配置同步作业前，您需要在目标实例中创建对应的库和表。
  • 暂不支持同步前缀索引，如果源库存在前缀索引可能导致数据同步失败。
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据迁移。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 对于表级别的数据同步，请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 对于表级别的数据同步，如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management Service）来执行在线DDL变更，请参见不锁表结构变更。
    警告 如果有除DTS外的数据写入目标库，请勿使用DMS执行在线DDL变更，否则可能引起目标库数据丢失。
特殊情况 当源库为自建MySQL时
  • 在同步时，如果源库进行主备切换，将会导致同步任务失败。
  • 由于DTS的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行DML操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个DML操作来更新延迟信息。
    说明 如果同步对象选择为整库，您还可以创建心跳表，心跳表每秒定期更新或者写入数据。