文档首页/ 云数据迁移 CDM/ 用户指南/ 在CDM集群中创建连接/ 配置连接参数/ 云数据库MySQL/MySQL数据库连接参数说明
更新时间:2024-12-02 GMT+08:00

云数据库MySQL/MySQL数据库连接参数说明

连接MySQL数据库连接时,相关参数如表1所示。

作业运行中禁止修改密码或者更换用户。在作业运行过程中修改密码或者更换用户,密码不会立即生效且作业会运行失败。

表1 MySQL数据库连接参数

参数名

说明

取值样例

名称

连接的名称,根据连接的数据源类型,用户可自定义便于记忆、区分的连接名。

mysql_link

数据库服务器

配置为要连接的数据库的IP地址或域名。

单击输入框后的“选择”,可获取用户的MySQL数据库实例列表。

192.168.0.1

端口

配置为要连接的数据库的端口。

3306

数据库名称

配置为要连接的数据库名称。

dbname

用户名

待连接数据库的用户。该数据库用户需要有数据表的读写权限,以及对元数据的读取权限。

cdm

密码

用户名密码。

-

使用本地API

可选参数,选择是否使用数据库本地API加速。

创建MySQL连接时,CDM会自动尝试启用MySQL数据库的local_infile系统变量,开启MySQL的LOAD DATA功能加快数据导入,提高导入数据到MySQL数据库的性能。注意,开启本参数后,日期类型将不符合格式的会存储为0000-00-00,更多详细信息可在MySQL官网文档查看。

如果CDM自动启用失败,请联系数据库管理员启用local_infile参数或选择不使用本地API加速。

如果是导入到RDS上的MySQL数据库,由于RDS上的MySQL默认没有开启LOAD DATA功能,所以同时需要修改MySQL实例的参数组,将“local_infile”设置为“ON”,开启该功能。

说明:

如果RDS上的“local_infile”参数组不可编辑,则说明是默认参数组,需要先创建一个新的参数组,再修改该参数值,并应用到RDS的MySQL实例上,具体操作请参见《关系型数据库用户指南》

使用Agent

Agent功能待下线,无需配置。

-

Agent

Agent功能待下线,无需配置。

-

local_infile字符集

MySQL通过local_infile导入数据时,可配置编码格式。

utf8

驱动版本

不同类型的关系数据库,需要适配不同的驱动。

-

单次请求行数

可选参数,单击“显示高级属性”后显示。

指定每次请求获取的行数,根据数据源端和作业数据规模的大小配置该参数。如果配置过大或过小,可能影响作业的时长。

1000

单次提交行数

可选参数,单击“显示高级属性”后显示。

指定每次批量提交的行数,根据数据目的端和作业数据规模的大小配置该参数。如果配置过大或过小,可能影响作业的时长。

10000

SSL加密

可选参数,控制是否通过SSL加密方式连接数据库,创建云数据MySQL连接时显示该参数。

连接属性

可选参数,单击“添加”可增加多个指定数据源的JDBC连接器的属性,参考对应数据库的JDBC连接器说明文档进行配置。

常见配置举例如下:
  • connectTimeout=600000socketTimeout=300000:迁移数据量较大、或通过查询语句检索全表时,会由于连接超时导致迁移失败。此时可自定义连接超时时间与socket超时时间(单位ms),避免超时导致失败。
  • tinyInt1isBit=falsemysql.bool.type.transform=false:MySQL默认开启配置tinyInt1isBit=true,将TINYINT(1)当作BIT也就是Types.BOOLEAN来处理,会将1或0读取为true或false从而导致迁移失败,此时可关闭配置避免迁移报错。
  • useCursorFetch=false:CDM作业默认打开了JDBC连接器与关系型数据库通信使用二进制协议开关,即useCursorFetch=true。部分第三方可能存在兼容问题导致迁移时间转换出错,可以关闭此开关;开源MySQL数据库支持useCursorFetch参数,无需对此参数进行设置。
  • allowPublicKeyRetrieval=true:MySQL默认关闭允许公钥检索机制,因此连接MySQL数据源时,如果TLS不可用、使用RSA公钥加密时,可能导致连接报错。此时可打开公钥检索机制,避免连接报错。
  • useSSL=false:CDM集群版本为2.10.0.300且MySQL版本为mysql5.7.43以上时,可以通过添加连接属性useSSL=false打开SSL加密开关

sslmode=require

引用符号

可选参数,连接引用表名或列名时的分隔符号,参考对应数据库的产品文档进行配置。

`

单次写入行数

指定单次批量写入的行数,当写入行数累计到单次批量提交行数时提交一次,该值应当小于单次提交行数。

100