文档简介：
操作场景
本章节介绍使用CDM整库迁移功能，将本地MySQL数据库迁移到云服务RDS中。
当前CDM支持将本地MySQL数据库，整库迁移到RDS上的MySQL、PostgreSQL或者Microsoft SQL Server任意一种数据库中。这里以整库迁移到RDS上的MySQL数据库为例进行介绍，使用流程如下：
1.创建CDM集群并绑定EIP
2.创建MySQL连接
3.创建RDS连接
4.创建整库迁移作业
前提条件
- 用户拥有EIP配额。
- 用户已创建RDS数据库实例，该实例的数据库引擎为MySQL。
- 本地MySQL数据库可通过公网访问。如果MySQL服务器是在本地数据中心或第三方云上，需要确保MySQL可以通过公网IP访问，或者是已经建立好了企业内部数据中心到云服务平台的VPN通道或专线。
- 已获取本地MySQL数据库和RDS上MySQL数据库的IP地址、数据库名称、用户名和密码。
- 用户已参考管理驱动，上传了MySQL数据库驱动。
创建CDM集群并绑定EIP
1.参考创建CDM集群，创建CDM集群。
关键配置如下：
- CDM集群的规格，按待迁移的数据量选择，一般选择cdm.medium即可，满足大部分迁移场景。
- CDM集群的VPC，选择和RDS的MySQL数据库实例所在的VPC一致，且推荐子网、安全组也与RDS上的MySQL一致。
- 如果安全控制原因不能使用相同子网和安全组，则可以修改安全组规则，允许CDM访问RDS。
2.CDM集群创建完成后，选择集群操作列的“绑定弹性IP”，CDM通过EIP访问本地MySQL数据库。
详见下图：集群列表
如果用户对本地数据源的访问通道做了SSL加密，则CDM无法通过弹性IP连接数据源。
创建MySQL连接
1.在CDM集群管理界面，单击集群后的“作业管理”，选择“连接管理 > 新建连接”，进入连接器类型的选择界面。
2.选择“MySQL”后单击“下一步”，配置MySQL连接的参数。
单击“显示高级属性”可查看更多可选参数，具体请参见配置常见关系数据库连接。这里保持默认，必填参数如下表所示。
表 MySQL连接参数
| 参数名 | 说明 | 取值样例 |
|---|---|---|
| 名称 | 输入便于记忆和区分的连接名称。 | mysqllink |
| 数据库服务器 | MySQL数据库的IP地址或域名。 | 192.168.1.110 |
| 端口 | MySQL数据库的端口。 | 3306 |
| 数据库名称 | MySQL数据库的名称。 | sqoop |
| 用户名 | 拥有MySQL数据库的读、写和删除权限的用户。 | admin |
| 密码 | 用户的密码。 | - |
| 使用本地API | 使用数据库本地API加速（系统会尝试启用MySQL数据库的local_infile系统变量）。 | 是 |
| 使用Agent | 是否选择通过Agent从源端提取数据。 | 是 |
| local_infile字符集 | mysql通过local_infile导入数据时，可配置编码格式。 | utf8 |
| 驱动版本 | 适配mysql的驱动。 | - |
| Agent | 单击“选择”，选择连接Agent中已创建的Agent。 | - |
| 单次请求行数 | 指定每次请求获取的行数。 | 1000 |
| 单次提交行数 | 支持通过agent从源端提取数据 | 1000 |
| 连接属性 | 自定义连接属性。 | useCompression=true |
| 引用符号 | 连接引用表名或列名时的分隔符号。默认为空。 | ' |
| 单次写入行数 | 指定单次批量写入的行数，当写入行数累计到单次批量提交行数时提交一次，该值应当小于单次提交行数。 | 100 |
3.单击“保存”回到连接管理界面。
如果保存时出错，一般是由于MySQL数据库的安全设置问题，需要设置允许CDM集群的EIP访问MySQL数据库。
创建RDS连接
1.单击CDM集群后的“作业管理”，进入作业管理界面，再选择“连接管理 > 新建连接”，进入选择连接器类型的界面。
2.连接器类型选择“云数据库 MySQL”后单击“下一步”，配置连接参数：
- 名称：用户自定义连接名称，例如：“rds_link”。
- 数据库服务器、端口：配置为RDS上MySQL数据库的连接地址、端口。
- 数据库名称：配置为RDS上MySQL数据库的名称。
- 用户名、密码：登录数据库的用户和密码。
-
创建RDS连接时，“使用本地API”设置为“是”时，可以使用MySQL的LOAD DATA功能加快数据导入，提高导入数据到MySQL的性能。
-
由于RDS上的MySQL默认没有开启LOAD DATA功能，所以同时需要修改MySQL实例的参数组，将“local_infile”设置为“ON”，开启该功能。
-
如果“local_infile”参数组不可编辑，则说明是默认参数组，需要先创建一个新的参数组，再修改该参数值，并应用到RDS的MySQL实例上。
3.单击“保存”回到连接管理界面。
创建整库迁移作业
1.两个连接创建完成后，选择“整库迁移 > 新建作业”，开始创建迁移任务，如下图所示。
图 创建整库迁移作业
- 作业名称：用户自定义整库迁移的任务名称。
- 源端作业配置
−源连接名称：选择上述 创建MySQL连接 中的“mysql_link”。
−模式或表空间：选择从本地MySQL的哪个数据库导出数据。
- 目的端作业配置
−目的连接名称：选择上述 创建RDS连接 中的“rds_link”。
−模式或表空间：选择将数据导入到RDS的哪个数据库。
−自动创表：选择“不存在时创建”，当RDS数据库中没有本地MySQL数据库里的表时，CDM会自动在RDS数据库中创建那些表。
−导入前清空数据：选择“是”，当RDS数据库中存在与本地MySQL数据库重名的表时，CDM会清除RDS中重名表里的数据。
−高级属性里的可选参数保持默认即可。
2.单击“下一步”，进入选择待迁移表的界面，您可以选择全部或者部分表进行迁移。
3.单击“保存并运行”，CDM会立即开始执行整库迁移任务。
作业任务启动后，每个待迁移的表都会生成一个子任务，单击整库迁移的作业名称，可查看子任务列表。
4.单击作业操作列的“历史记录”，可查看该作业的历史执行记录、读取和写入的统计数据。
整库迁移的作业没有日志，子作业才有。在子作业的历史记录界面单击“日志”，可查看作业的日志信息。
