同步时源库为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等操作，否则数据同步任务会失败，或者数据不一致。

  • 在全量同步阶段，请勿执行库或表结构变更的DDL操作，否则会导致数据同步任务失败。

• 源PolarDB-X 1.0实例的版本需为5.2及以上版本。查看版本的方法，请参见实例版本概览。

其他限制

• DTS基于源PolarDB-X 1.0实例中XA事务的连续性，以确保增量同步任务数据的一致性。若XA事务的连续性遭到破坏（包括但不限于修改同步对象、增量数据采集模块容灾等场景），则未提交的XA事务可能会丢失。

• 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变更，可能引起目标库数据丢失。

• 若实例运行失败，DTS技术支持人员将在8小时内尝试恢复该实例。在恢复失败实例的过程中，可能会对该实例进行重启、调整参数等操作。

  说明

  在调整参数时，仅会修改实例的参数，不会对数据库中的参数进行修改。可能修改的参数，包括但不限于修改实例参数中的参数。

类型

说明

源库限制

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

• 如同步对象为表级别，且需进行编辑（如表列名映射），单次同步任务的表数量超过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等操作，否则数据同步任务会失败，或者数据不一致。

  • 在库表结构同步和全量同步阶段，请勿执行库或表结构变更的DDL操作，否则会导致数据同步任务失败。

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

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

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

• 源PolarDB-X 1.0实例的版本需为5.2及以上版本。查看版本的方法，请参见实例版本概览。

其他限制

• DTS基于源PolarDB-X 1.0实例中XA事务的连续性，以确保增量同步任务数据的一致性。若XA事务的连续性遭到破坏（包括但不限于修改同步对象、增量数据采集模块容灾等场景），则未提交的XA事务可能会丢失。

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

• 若待同步的数据中包含需要四字节存储的内容（例如生僻字、表情等信息），则目标端接收数据的数据库和表必须使用utf8mb4字符集。

  说明

  若您使用DTS同步库表结构，则需将目标库中实例级别的参数character_set_server设置为utf8mb4。

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

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

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

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

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

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

• 若实例运行失败，DTS技术支持人员将在8小时内尝试恢复该实例。在恢复失败实例的过程中，可能会对该实例进行重启、调整参数等操作。

  说明

  在调整参数时，仅会修改实例的参数，不会对数据库中的参数进行修改。可能修改的参数，包括但不限于修改实例参数中的参数。

类型

说明

源库限制

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

• 如同步对象为表级别，且需进行编辑（如表列名映射），单次同步任务的表数量超过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等操作，否则数据同步任务会失败，或者数据不一致。

  • 在库表结构同步和全量同步阶段，请勿执行库或表结构变更的DDL操作，否则会导致数据同步任务失败。

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

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

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

• 源PolarDB-X 1.0实例的版本需为5.2及以上版本。查看版本的方法，请参见实例版本概览。

其他限制

• DTS基于源PolarDB-X 1.0实例中XA事务的连续性，以确保增量同步任务数据的一致性。若XA事务的连续性遭到破坏（包括但不限于修改同步对象、增量数据采集模块容灾等场景），则未提交的XA事务可能会丢失。

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

• 若DTS任务运行时目标AnalyticDB MySQL版 3.0集群处于备份中的状态，则会导致任务失败。

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

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

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

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

• 若实例运行失败，DTS技术支持人员将在8小时内尝试恢复该实例。在恢复失败实例的过程中，可能会对该实例进行重启、调整参数等操作。

  说明

  在调整参数时，仅会修改实例的参数，不会对数据库中的参数进行修改。可能修改的参数，包括但不限于修改实例参数中的参数。

类型

说明

源库限制

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

• 如同步对象为表级别，且需进行编辑（如表列名映射），单次同步任务的表数量超过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等操作，否则数据同步任务会失败，或者数据不一致。

  • 在库表结构同步阶段，请勿执行库或表结构变更的DDL操作，否则会导致数据同步任务失败。

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

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

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

• 源PolarDB-X 1.0实例的版本需为5.2及以上版本。查看版本的方法，请参见实例版本概览。

其他限制

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

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

• 同步对象的限制：

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

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

• DTS基于源PolarDB-X 1.0实例中XA事务的连续性，以确保增量同步任务数据的一致性。若XA事务的连续性遭到破坏（包括但不限于修改同步对象、增量数据采集模块容灾等场景），则未提交的XA事务可能会丢失。

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

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

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

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

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

• 若实例运行失败，DTS技术支持人员将在8小时内尝试恢复该实例。在恢复失败实例的过程中，可能会对该实例进行重启、调整参数等操作。

  说明

  在调整参数时，仅会修改实例的参数，不会对数据库中的参数进行修改。可能修改的参数，包括但不限于修改实例参数中的参数。