从RDS MySQL同步到AnalyticDB for MySQL

注意事项

• DTS在执行全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升，在数据库性能较差、规格较低或业务量较大的情况下（例如源库有大量慢SQL、存在无主键表或目标库存在死锁等），可能会加重数据库压力，甚至导致数据库服务不可用。因此您需要在执行数据同步前评估源库和目标库的性能，同时建议您在业务低峰期执行数据同步（例如源库和目标库的CPU负载在30%以下）。
• 请勿在数据同步时，对源库的同步对象使用gh-ost或pt-online-schema-change等类似工具执行在线DDL变更，否则会导致同步失败。
• 由于AnalyticDB for MySQL本身的使用限制，当AnalyticDB for MySQL集群中的节点磁盘空间使用量超过80%，该集群将被锁定。请提前根据待同步的对象预估所需空间，确保目标集群具备充足的存储空间。
• 暂不支持同步前缀索引，如果源库存在前缀索引可能导致数据同步失败。

支持同步的SQL操作

• DDL操作：CREATE TABLE、DROP TABLE、RENAME TABLE、TRUNCATE TABLE、ADD COLUMN、DROP COLUMN
• DML操作：INSERT、UPDATE、DELETE

数据库账号的权限要求

数据类型映射关系

由于MySQL和AnalyticDB for MySQL的数据类型并不是一一对应的，所以DTS在进行结构初始化时，会根据数据类型定义进行类型映射，详情请参见结构初始化涉及的数据类型映射关系。

操作步骤

1. 购买数据同步作业，详情请参见购买流程。
   说明 购买时，选择源实例为MySQL，目标实例为AnalyticDB for MySQL，并选择同步拓扑为单向同步。
2. 登录数据传输控制台。
3. 在左侧导航栏，单击数据同步。
4. 在同步作业列表页面顶部，选择数据同步实例所属地域。
   
5. 定位至已购买的数据同步实例，单击配置同步链路。
6. 配置同步通道的源实例及目标实例信息。
   

   类别	配置	说明
   无	同步作业名称	DTS会自动生成一个同步作业名称，建议配置具有业务意义的名称（无唯一性要求），便于后续识别。
   源实例信息	实例类型	选择RDS实例。
   	实例地区	购买数据同步实例时选择的源实例地域信息，不可变更。
   	实例ID	选择源RDS实例ID。
   	数据库账号	填入源RDS的数据库账号，权限要求请参见数据库账号的权限要求。 说明 当源RDS实例的数据库类型为MySQL 5.5或MySQL 5.6时，无需配置数据库账号和数据库密码。
   	数据库密码	填入该数据库账号对应的密码。
   	连接方式	根据需求选择非加密连接或SSL安全连接。如果设置为SSL安全连接，您需要提前开启RDS实例的SSL加密功能，详情请参见设置SSL加密。 注意 目前仅中国内地及中国香港地域支持设置连接方式。
   目标实例信息	实例类型	固定为ADS，不可变更。
   	实例地区	购买数据同步实例时选择的目标实例地域信息，不可变更。
   	版本	选择为3.0。
   	数据库	选择目标AnalyticDB for MySQL的集群ID。
   	数据库账号	填入AnalyticDB for MySQL的数据库账号，权限要求请参见数据库账号的权限要求。
   	数据库密码	填入该数据库账号对应的密码。

7. 单击页面右下角的授权白名单并进入下一步。
8. 配置同步策略及对象信息。
   

   配置	说明
   同步初始化	默认情况下，您需要同时选中结构初始化和全量数据初始化。预检查完成后，DTS会将源实例中待同步对象的结构及数据在目标集群中初始化，作为后续增量同步数据的基线数据。
   目标已存在表的处理模式	预检查并报错拦截：检查目标数据库中是否有同名的表。如果目标数据库中没有同名的表，则通过该检查项目；如果目标数据库中有同名的表，则在预检查阶段提示错误，数据同步作业不会被启动。 说明 如果目标库中同名的表不方便删除或重命名，您可以更改该表在目标库中的名称，详情请参见设置同步对象在目标实例中的名称。 忽略报错并继续执行：跳过目标数据库中是否有同名表的检查项。 警告 选择为忽略报错并继续执行，可能导致数据不一致，给业务带来风险，例如： 表结构一致的情况下，在目标库遇到与源库主键的值相同的记录，则会保留目标集群中的该条记录，即源库中的该条记录不会同步至目标数据库中。 表结构不一致的情况下，可能会导致无法初始化数据、只能同步部分列的数据或同步失败。
   多表归并	选择为是：DTS将在每个表中增加__dts_data_source列来存储数据来源，且不再支持DDL同步。 选择为否：默认选项，支持DDL同步。 说明 多表归并功能基于任务级别，即不支持基于表级别执行多表归并。如果需要让部分表执行多表归并，另一部分不执行多表归并，您可以创建两个数据同步作业。
   同步操作类型	根据业务选中需要同步的操作类型，默认情况下都处于选中状态。 说明 目前仅支持INSERT、UPDATE、DELETE、ADD COLUMN。
   选择同步对象	在源库对象框中单击待同步的对象，然后单击图标将其移动至已选择对象框。 同步对象的选择粒度为库、表。 说明 如果选择整个库作为同步对象，那么该库中所有对象的结构变更操作会同步至目标库。 如果选择某个表作为同步对象，那么只有这个表的ADD COLUMN操作会同步至目标库。 默认情况下，同步对象的名称保持不变。如果您需要同步对象在目标集群上名称不同，请使用对象名映射功能，详情请参见设置同步对象在目标实例中的名称。

9. 上述配置完成后，单击页面右下角的下一步。
10. 设置待同步的表在目标库中类型。
    

    说明 选择了结构初始化后，您需要定义待同步的表在AnalyticDB for MySQL中的类型、主键列、分区列等信息，详情请参见CREATE TABLE操作手册。
11. 上述配置完成后，单击页面右下角的预检查并启动。
    说明

    • 在数据同步作业正式启动之前，会先进行预检查。只有预检查通过后，才能成功启动数据同步作业。
    • 如果预检查失败，单击具体检查项后的图标，查看失败详情。根据提示修复后，重新进行预检查。
12. 在预检查对话框中显示预检查通过后，关闭预检查对话框，同步作业将正式开始。
13. 等待同步作业的链路初始化完成，直至处于同步中状态。

    您可以在数据同步页面，查看数据同步作业的状态。

    

修复因变更字段类型导致的同步失败

本案例中，同步失败的表在AnalyticDB for MySQL中的名称为customer。

1. 在AnalyticDB for MySQL中创建一个新表（customer_new），表结构与customer表保持一致。
2. 通过INSERT INTO SELECT命令，将customer表的数据复制并插入到新创建的customer_new表中，确保两张表的数据保持一致。
3. 重命名或删除同步失败的表，然后将customer_new表的名称修改为customer。
4. 在DTS控制台，重新启动数据同步作业。