如果同步的源实例为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操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 请勿对源库的同步对象使用gh-ost或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操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 在DTS同步期间，不允许有除DTS外的数据写入目标库，否则会导致源库与目标库数据不一致。例如，有除DTS外的数据写入目标库时，使用DMS执行在线DDL变更，可能引起目标库数据丢失。

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操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 在DTS同步期间，不允许有除DTS外的数据写入目标库，否则会导致源库与目标库数据不一致。例如，有除DTS外的数据写入目标库时，使用DMS执行在线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实例。
  • 由于PolarDB-X 1.0的同步任务为分布式同步，其下挂的一个RDS MySQL对应一个同步子任务。子任务运行情况，可在任务拓扑进行查询。
  • 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据同步。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
  • 全量初始化会并发执行INSERT操作，导致目标数据库的表产生碎片，因此全量初始化完成后目标实例的表空间比源实例的表空间大。
  • 请勿对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
  • 在DTS同步期间，不允许有除DTS外的数据写入目标库，否则会导致源库与目标库数据不一致。例如，有除DTS外的数据写入目标库时，使用DMS执行在线DDL变更，可能引起目标库数据丢失。