迁移时源库为PolarDB-X 2.0的注意事项及限制

类型

说明

源库限制

• 带宽要求：源库所属的服务器需具备足够出口带宽，否则将影响数据迁移速率。

• 待迁移的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。

• 如迁移对象为表级别，且需进行编辑（如表列名映射），则单次迁移任务仅支持迁移至多1000张表。当超出数量限制，任务提交后会显示请求报错，此时建议您拆分待迁移的表，分批配置多个任务，或者配置整库的迁移任务。

• 如需进行增量迁移，Binlog日志：

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

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

• 若源端PolarDB-X 2.0待迁移的表名中含大写字母，则仅支持库表结构迁移。

• 源库的操作限制：

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

  • 迁移期间如需切换PolarDB分布式版 的网络类型，切换成功后，请调整迁移链路的网络连接信息。

  • 如仅执行全量数据迁移，请勿向源实例中写入新的数据，否则会导致源和目标数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。

• PolarDB分布式版需兼容MySQL 5.7版本。

其他限制

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

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

• DTS会尝试恢复七天之内迁移失败任务。因此业务切换至目标实例前，请务必结束或释放该任务，或者将DTS访问目标实例账号的写权限用revoke命令回收掉。避免该任务被自动恢复后，源端数据覆盖目标实例的数据。

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

  说明

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

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

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

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

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

  说明

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

其他注意事项

• DTS会在源库定时更新`dts_health_check`.`ha_health_check`表以推进binlog位点。

• 当目标库为RDS MySQL时

  DTS会自动在RDS MySQL中创建数据库，如果待迁移的数据库名称不符合RDS MySQL的定义规范，您需要在配置迁移任务之前在RDS MySQL中创建数据库。相关操作，请参见管理数据库。

类型

说明

源库限制

• 带宽要求：源库所属的服务器需具备足够出口带宽，否则将影响数据迁移速率。

• 待迁移的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。

• 如迁移对象为表级别，且需进行编辑（如表列名映射），则单次迁移任务仅支持迁移至多1000张表。当超出数量限制，任务提交后会显示请求报错，此时建议您拆分待迁移的表，分批配置多个任务，或者配置整库的迁移任务。

• 如需进行增量迁移，Binlog日志：

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

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

• 若源端PolarDB-X 2.0待迁移的表名中含大写字母，则仅支持库表结构迁移。

• 源库的操作限制：

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

  • 迁移期间如需切换PolarDB分布式版 的网络类型，切换成功后，请调整迁移链路的网络连接信息。

  • 如仅执行全量数据迁移，请勿向源实例中写入新的数据，否则会导致源和目标数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。

• PolarDB分布式版需兼容MySQL 5.7版本。

其他限制

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

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

• DTS会尝试恢复七天之内迁移失败任务。因此业务切换至目标实例前，请务必结束或释放该任务，或者将DTS访问目标实例账号的写权限用revoke命令回收掉。避免该任务被自动恢复后，源端数据覆盖目标实例的数据。

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

  说明

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

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

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

  说明

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

其他注意事项

• DTS会在源库定时更新`dts_health_check`.`ha_health_check`表以推进binlog位点。

• 当目标库为PolarDB MySQL版时：

  DTS会自动在PolarDB MySQL版中创建数据库，如果待迁移的数据库名称不符合PolarDB MySQL版的定义规范，您需要在配置迁移任务之前在PolarDB MySQL版中创建数据库。相关操作，请参见管理数据库。

类型

说明

源库限制

• 带宽要求：源库所属的服务器需具备足够出口带宽，否则将影响数据迁移速率。

• 待迁移的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。

• 如迁移对象为表级别，且需进行编辑（如表列名映射），则单次迁移任务仅支持迁移至多1000张表。当超出数量限制，任务提交后会显示请求报错，此时建议您拆分待迁移的表，分批配置多个任务，或者配置整库的迁移任务。

• 如需进行增量迁移，Binlog日志：

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

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

• 若源端PolarDB-X 2.0待迁移的表名中含大写字母，则仅支持库表结构迁移。

• 源库的操作限制：

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

  • 迁移期间如需切换PolarDB分布式版 的网络类型，切换成功后，请调整迁移链路的网络连接信息。

  • 如仅执行全量数据迁移，请勿向源实例中写入新的数据，否则会导致源和目标数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。

• PolarDB分布式版需兼容MySQL 5.7版本。

其他限制

• 目标实例PolarDB分布式版需兼容MySQL 5.7版本。

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

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

• DTS会尝试恢复七天之内迁移失败任务。因此业务切换至目标实例前，请务必结束或释放该任务，或者将DTS访问目标实例账号的写权限用revoke命令回收掉。避免该任务被自动恢复后，源端数据覆盖目标实例的数据。

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

  说明

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

其他注意事项

DTS会在源库定时更新`dts_health_check`.`ha_health_check`表以推进binlog位点。

类型

说明

源库限制

• 带宽要求：源库所属的服务器需具备足够出口带宽，否则将影响数据迁移速率。

• 待迁移的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。

• 如迁移对象为表级别，且需进行编辑（如表列名映射），则单次迁移任务仅支持迁移至多1000张表。当超出数量限制，任务提交后会显示请求报错，此时建议您拆分待迁移的表，分批配置多个任务，或者配置整库的迁移任务。

• 如需进行增量迁移，Binlog日志：

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

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

• 若源端PolarDB-X 2.0待迁移的表名中含大写字母，则仅支持库表结构迁移。

• 源库的操作限制：

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

  • 迁移期间如需切换PolarDB分布式版 的网络类型，切换成功后，请调整迁移链路的网络连接信息。

  • 如仅执行全量数据迁移，请勿向源实例中写入新的数据，否则会导致源和目标数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。

• PolarDB分布式版需兼容MySQL 5.7版本。

其他限制

• 暂不支持迁移前缀索引，如果源库存在前缀索引可能导致数据迁移失败。

• 由于云原生数据仓库AnalyticDB MySQL版 3.0本身的使用限制，当云原生数据仓库AnalyticDB MySQL版 3.0中的节点磁盘空间使用量超过80%，会导致DTS任务异常，产生延迟。请提前根据待迁移的对象预估所需空间，确保目标集群具备充足的存储空间。

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

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

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

• DTS会尝试恢复七天之内迁移失败任务。因此业务切换至目标实例前，请务必结束或释放该任务，或者将DTS访问目标实例账号的写权限用revoke命令回收掉。避免该任务被自动恢复后，源端数据覆盖目标实例的数据。

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

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

  说明

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

其他注意事项

DTS会在源库定时更新`dts_health_check`.`ha_health_check`表以推进binlog位点。

类型

说明

源库限制

• 带宽要求：源库所属的服务器需具备足够出口带宽，否则将影响数据迁移速率。

• 待迁移的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。

• 如迁移对象为表级别，且需进行编辑（如表列名映射），则单次迁移任务仅支持迁移至多1000张表。当超出数量限制，任务提交后会显示请求报错，此时建议您拆分待迁移的表，分批配置多个任务，或者配置整库的迁移任务。

• 如需进行增量迁移，Binlog日志：

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

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

• 若源端PolarDB-X 2.0待迁移的表名中含大写字母，则仅支持库表结构迁移。

• 源库的操作限制：

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

  • 迁移期间如需切换PolarDB分布式版 的网络类型，切换成功后，请调整迁移链路的网络连接信息。

  • 如仅执行全量数据迁移，请勿向源实例中写入新的数据，否则会导致源和目标数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。

• PolarDB分布式版需兼容MySQL 5.7版本。

其他限制

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

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

• DTS会尝试恢复七天之内迁移失败任务。因此业务切换至目标实例前，请务必结束或释放该任务，或者将DTS访问目标实例账号的写权限用revoke命令回收掉。避免该任务被自动恢复后，源端数据覆盖目标实例的数据。

• 在迁移期间，若目标Kafka发生了扩容或缩容，您需要重启实例。

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

  说明

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

其他注意事项

DTS会在源库定时更新`dts_health_check`.`ha_health_check`表以推进binlog位点。

类型

说明

源库限制

• 带宽要求：源库所属的服务器需具备足够出口带宽，否则将影响数据迁移速率。

• 待迁移的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。

• 如迁移对象为表级别，且需进行编辑（如表列名映射），则单次迁移任务仅支持迁移至多1000张表。当超出数量限制，任务提交后会显示请求报错，此时建议您拆分待迁移的表，分批配置多个任务，或者配置整库的迁移任务。

• 如需进行增量迁移，Binlog日志：

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

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

• 若源端PolarDB-X 2.0待迁移的表名中含大写字母，则仅支持库表结构迁移。

• 源库的操作限制：

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

  • 迁移期间如需切换PolarDB分布式版 的网络类型，切换成功后，请调整迁移链路的网络连接信息。

  • 如仅执行全量数据迁移，请勿向源实例中写入新的数据，否则会导致源和目标数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。

• PolarDB分布式版需兼容MySQL 5.7版本。

其他限制

• 如果源库中待迁移的表需要执行增加列的操作，您只需先在Elasticsearch实例中修改对应表的mapping，然后在源数据库中执行相应的DDL操作，最后暂停并启动迁移任务。

• 不支持开发测试型规格的Elasticsearch实例。

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

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

• DTS会尝试恢复七天之内迁移失败任务。因此业务切换至目标实例前，请务必结束或释放该任务，或者将DTS访问目标实例账号的写权限用revoke命令回收掉。避免该任务被自动恢复后，源端数据覆盖目标实例的数据。

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

  说明

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

其他注意事项

DTS会在源库定时更新`dts_health_check`.`ha_health_check`表以推进binlog位点。