全部产品
Search
文档中心

数据传输服务 DTS:同步时源库为PolarDB-X 1.0的注意事项及限制

更新时间:Dec 01, 2023

如果同步的源实例为PolarDB-X 1.0,您需要在配置具体的同步任务前,参考本文的注意事项及限制,以保障数据同步任务的正常运行。

重要

更多功能规范和约束说明,请参见源为PolarDB-X的功能规范和约束说明

推荐的任务配置方案,请参见源为PolarDB-X的任务配置方案

源库为PolarDB-X 1.0的同步方案概览

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

说明

DTS默认同步到目标数据库中时会取消外键约束,因此源数据库的级联、删除等操作不会同步到如下目标数据库:

  • PolarDB-X 1.0

  • MySQL(RDS MySQL、自建MySQL)

  • PolarDB MySQL版

  • 云原生数据仓库AnalyticDB MySQL

PolarDB-X 1.0间同步

类型

说明

源库限制

  • 待同步的表需具备主键或唯一约束(仅具有唯一约束的表不支持库表结构同步,建议使用主键约束),且字段具有唯一性,否则可能会导致目标数据库中出现重复数据;不支持二级索引表同步。

  • 如同步对象为表级别,且需进行编辑(如表列名映射),单次同步任务的表数量超过5000时,建议您拆分待同步的表,分批配置多个任务,或者配置整库的同步任务,否则任务提交后可能会显示请求报错。

  • PolarDB-X 1.0下面挂载的RDS MySQL的Binlog日志:

    • 需开启,并且binlog_row_image为full。否则预检查阶段提示报错,且无法成功启动数据同步任务。

    • 如为增量同步任务,DTS要求源数据库的本地Binlog日志保存24小时以上,如为全量同步和增量同步任务,DTS要求源数据库的本地Binlog日志至少保留7天以上(您可在全量同步完成后将Binlog保存时间设置为24小时以上),否则DTS可能因无法获取Binlog而导致任务失败,极端情况下甚至可能会导致数据不一致或丢失。由于您所设置的Binlog日志保存时间低于DTS要求的时间进而导致的问题,不在DTS的SLA保障范围内。

  • 源库的操作限制:

    • 同步期间如需切换PolarDB-X 1.0的网络类型,切换成功后,请调整同步链路的网络连接信息。

    • 在同步期间,请勿对源实例执行扩缩容(比如扩缩容其下挂载的RDS MySQL,或者虽未扩缩容RDS MySQL,但RDS MySQL中逻辑库表对应的物理库表的分布发生变化)、迁移热点表、变更拆分键操作和变更DDL等操作,否则数据同步任务会失败,或者数据不一致。

其他限制

  • PolarDB-X 1.0的存储类型支持为RDS MySQL(包括私有定制RDS和单独购买的RDS),暂不支持为PolarDB MySQL版

  • 不支持为PolarDB-X 1.0计算资源只读实例。

  • 仅支持PolarDB-X 1.0存储资源通过水平拆分(分库分表),不支持为垂直拆分。

  • 由于PolarDB-X 1.0的同步任务为分布式同步,其下挂的一个RDS MySQL对应一个同步子任务。子任务运行情况,可在任务拓扑进行查询。

  • 执行数据同步前需评估源库和目标库的性能,同时建议业务低峰期执行数据同步。否则全量数据初始化时将占用源库和目标库一定的读写资源,可能会导致数据库的负载上升。

  • 全量初始化会并发执行INSERT操作,导致目标数据库的表产生碎片,因此全量初始化完成后目标实例的表空间比源实例的表空间大。

  • 请勿对源库的同步对象使用pt-online-schema-change等类似工具执行在线DDL变更,否则会导致同步失败。

  • 在DTS同步期间,不允许有除DTS外的数据写入目标库,否则会导致源库与目标库数据不一致。例如,有除DTS外的数据写入目标库时,使用DMS执行在线DDL变更,可能引起目标库数据丢失。

PolarDB-X 1.0同步至MySQL或PolarDB MySQL版

类型

说明

源库限制

  • 待同步的表需具备主键或唯一约束(仅具有唯一约束的表不支持库表结构同步,建议使用主键约束),且字段具有唯一性,否则可能会导致目标数据库中出现重复数据;不支持二级索引表同步。

  • 如同步对象为表级别,且需进行编辑(如表列名映射),单次同步任务的表数量超过5000时,建议您拆分待同步的表,分批配置多个任务,或者配置整库的同步任务,否则任务提交后可能会显示请求报错。

  • PolarDB-X 1.0下面挂载的RDS MySQL的Binlog日志:

    • 需开启,并且binlog_row_image为full。否则预检查阶段提示报错,且无法成功启动数据同步任务。

    • 如为增量同步任务,DTS要求源数据库的本地Binlog日志保存24小时以上,如为全量同步和增量同步任务,DTS要求源数据库的本地Binlog日志至少保留7天以上(您可在全量同步完成后将Binlog保存时间设置为24小时以上),否则DTS可能因无法获取Binlog而导致任务失败,极端情况下甚至可能会导致数据不一致或丢失。由于您所设置的Binlog日志保存时间低于DTS要求的时间进而导致的问题,不在DTS的SLA保障范围内。

  • 源库的操作限制:

    • 同步期间如需切换PolarDB-X 1.0的网络类型,切换成功后,请调整同步链路的网络连接信息。

    • 在同步期间,请勿对源实例执行扩缩容(比如扩缩容其下挂载的RDS MySQL,或者虽未扩缩容RDS MySQL,但RDS MySQL中逻辑库表对应的物理库表的分布发生变化)、迁移热点表、变更拆分键操作和变更DDL等操作,否则数据同步任务会失败,或者数据不一致。

  • PolarDB-X 1.0的存储类型支持为RDS MySQL(包括私有定制RDS和单独购买的RDS),暂不支持为PolarDB MySQL版

  • 仅支持PolarDB-X 1.0存储资源通过水平拆分(分库分表),不支持为垂直拆分。

  • 不支持为PolarDB-X 1.0计算资源只读实例。

其他限制

  • 由于PolarDB-X 1.0的同步任务为分布式同步,其下挂的一个RDS MySQL对应一个同步子任务。子任务运行情况,可在任务拓扑进行查询。

  • 执行数据同步前需评估源库和目标库的性能,同时建议业务低峰期执行数据同步。否则全量数据初始化时将占用源库和目标库一定的读写资源,可能会导致数据库的负载上升。

  • 全量初始化会并发执行INSERT操作,导致目标数据库的表产生碎片,因此全量初始化完成后目标实例的表空间比源实例的表空间大。

  • 请勿对源库的同步对象使用pt-online-schema-change等类似工具执行在线DDL变更,否则会导致同步失败。

  • 在DTS同步期间,不允许有除DTS外的数据写入目标库,否则会导致源库与目标库数据不一致。例如,有除DTS外的数据写入目标库时,使用DMS执行在线DDL变更,可能引起目标库数据丢失。

  • 若目标库的DDL写入失败,DTS任务会继续运行,您需要在任务日志中查看执行失败的DDL。查看任务日志的方法,请参见查询任务日志

  • 若您将列名仅大小写不同的字段写入到目标MySQL数据库的同一个表中,可能会因为MySQL数据库列名大小写不敏感,导致同步结果不符合预期。

  • 在数据同步完成后,建议使用analyze table <表名>命令检查数据是否已写入目标表。例如,在MySQL触发HA切换机制后,可能会导致数据只写到了内存,从而造成数据丢失。

PolarDB-X 1.0同步至云原生数据仓库AnalyticDB MySQL

类型

说明

源库限制

  • 待同步的表需具备主键或唯一约束(仅具有唯一约束的表不支持库表结构同步,建议使用主键约束),且字段具有唯一性,否则可能会导致目标数据库中出现重复数据;不支持二级索引表同步。

  • 如同步对象为表级别,且需进行编辑(如表列名映射),单次同步任务的表数量超过5000时,建议您拆分待同步的表,分批配置多个任务,或者配置整库的同步任务,否则任务提交后可能会显示请求报错。

  • PolarDB-X 1.0下面挂载的RDS MySQL的Binlog日志:

    • 需开启,并且binlog_row_image为full。否则预检查阶段提示报错,且无法成功启动数据同步任务。

    • 如为增量同步任务,DTS要求源数据库的本地Binlog日志保存24小时以上,如为全量同步和增量同步任务,DTS要求源数据库的本地Binlog日志至少保留7天以上(您可在全量同步完成后将Binlog保存时间设置为24小时以上),否则DTS可能因无法获取Binlog而导致任务失败,极端情况下甚至可能会导致数据不一致或丢失。由于您所设置的Binlog日志保存时间低于DTS要求的时间进而导致的问题,不在DTS的SLA保障范围内。

  • 源库的操作限制:

    • 同步期间如需切换PolarDB-X 1.0的网络类型,切换成功后,请调整同步链路的网络连接信息。

    • 在同步期间,请勿对源实例执行扩缩容(比如扩缩容其下挂载的RDS MySQL,或者虽未扩缩容RDS MySQL,但RDS MySQL中逻辑库表对应的物理库表的分布发生变化)、迁移热点表、变更拆分键操作和变更DDL等操作,否则数据同步任务会失败,或者数据不一致。

  • PolarDB-X 1.0的存储类型支持为RDS MySQL(包括私有定制RDS和单独购买的RDS),暂不支持为PolarDB MySQL版

  • 仅支持PolarDB-X 1.0存储资源通过水平拆分(分库分表),不支持为垂直拆分。

  • 不支持为PolarDB-X 1.0计算资源只读实例。

其他限制

  • 由于PolarDB-X 1.0的同步任务为分布式同步,其下挂的一个RDS MySQL对应一个同步子任务。子任务运行情况,可在任务拓扑进行查询。

  • 执行数据同步前需评估源库和目标库的性能,同时建议业务低峰期执行数据同步。否则全量数据初始化时将占用源库和目标库一定的读写资源,可能会导致数据库的负载上升。

  • 全量初始化会并发执行INSERT操作,导致目标数据库的表产生碎片,因此全量初始化完成后目标实例的表空间比源实例的表空间大。

  • 请勿对源库的同步对象使用pt-online-schema-change等类似工具执行在线DDL变更,否则会导致同步失败。

  • 在DTS同步期间,不允许有除DTS外的数据写入目标库,否则会导致源库与目标库数据不一致。例如,有除DTS外的数据写入目标库时,使用DMS执行在线DDL变更,可能引起目标库数据丢失。

  • 若目标库的DDL写入失败,DTS任务会继续运行,您需要在任务日志中查看执行失败的DDL。查看任务日志的方法,请参见查询任务日志

PolarDB-X 1.0同步至阿里云流式数据服务DataHub

类型

说明

源库限制

  • 待同步的表需具备主键或唯一约束(仅具有唯一约束的表不支持库表结构同步,建议使用主键约束),且字段具有唯一性,否则可能会导致目标数据库中出现重复数据;不支持二级索引表同步。

  • 如同步对象为表级别,且需进行编辑(如表列名映射),单次同步任务的表数量超过5000时,建议您拆分待同步的表,分批配置多个任务,或者配置整库的同步任务,否则任务提交后可能会显示请求报错。

  • PolarDB-X 1.0下面挂载的RDS MySQL的Binlog日志:

    • 需开启,并且binlog_row_image为full。否则预检查阶段提示报错,且无法成功启动数据同步任务。

    • 如为增量同步任务,DTS要求源数据库的本地Binlog日志保存24小时以上,如为全量同步和增量同步任务,DTS要求源数据库的本地Binlog日志至少保留7天以上(您可在全量同步完成后将Binlog保存时间设置为24小时以上),否则DTS可能因无法获取Binlog而导致任务失败,极端情况下甚至可能会导致数据不一致或丢失。由于您所设置的Binlog日志保存时间低于DTS要求的时间进而导致的问题,不在DTS的SLA保障范围内。

  • 源库的操作限制:

    • 同步期间如需切换PolarDB-X 1.0的网络类型,切换成功后,请调整同步链路的网络连接信息。

    • 在同步期间,请勿对源实例执行扩缩容(比如扩缩容其下挂载的RDS MySQL,或者虽未扩缩容RDS MySQL,但RDS MySQL中逻辑库表对应的物理库表的分布发生变化)、迁移热点表、变更拆分键操作和变更DDL等操作,否则数据同步任务会失败,或者数据不一致。

  • PolarDB-X 1.0的存储类型支持为RDS MySQL(包括私有定制RDS和单独购买的RDS),暂不支持为PolarDB MySQL版

  • 仅支持PolarDB-X 1.0存储资源通过水平拆分(分库分表),不支持为垂直拆分。

  • 不支持为PolarDB-X 1.0计算资源只读实例。

其他限制

  • 仅支持增量同步和库表结构同步,不支持全量同步。

  • 目标DataHub中单个String字段的长度最大支持2 MB。

  • 同步对象的限制:

    • 仅支持表级别的数据同步。

    • 不支持新增列的数据同步,即源库中同步对象表新增了某个列,该列的数据不会同步至目标DataHub实例。

  • 由于PolarDB-X 1.0的同步任务为分布式同步,其下挂的一个RDS MySQL对应一个同步子任务。子任务运行情况,可在任务拓扑进行查询。

  • 执行数据同步前需评估源库和目标库的性能,同时建议业务低峰期执行数据同步。否则全量数据初始化时将占用源库和目标库一定的读写资源,可能会导致数据库的负载上升。

  • 全量初始化会并发执行INSERT操作,导致目标数据库的表产生碎片,因此全量初始化完成后目标实例的表空间比源实例的表空间大。

  • 请勿对源库的同步对象使用pt-online-schema-change等类似工具执行在线DDL变更,否则会导致同步失败。

  • 在DTS同步期间,不允许有除DTS外的数据写入目标库,否则会导致源库与目标库数据不一致。例如,有除DTS外的数据写入目标库时,使用DMS执行在线DDL变更,可能引起目标库数据丢失。