HybridDB for MySQL数据源为您提供读取和写入HybridDB for MySQL的双向功能,本文为您介绍DataWorks的HybridDB for MySQL数据同步能力支持情况。
使用限制
- 离线同步支持读取视图表。
- HybridDB for MySQL Reader插件支持读取表和视图。表字段可以依序指定全部列、部分列、调整列顺序、指定常量字段和配置HybridDB for MySQL的函数,如now()等。
支持的字段类型
HybridDB for MySQL Reader和HybridDB for MySQL Writer针对HybridDB for MySQL类型的转换列表,如下所示。
类型分类 | HybridDB for MySQL数据类型 |
---|---|
整数类 | INT、TINYINT、SMALLINT、MEDIUMINT、BIGINT和YEAR |
浮点类 | FLOAT、DOUBLE和DECIMAL |
字符串类 | VARCHAR、CHAR、TINYTEXT、TEXT、MEDIUMTEXT和LONGTEXT |
日期时间类 | DATE、DATETIME、TIMESTAMP和TIME |
布尔类 | BOOL |
二进制类 | TINYBLOB、MEDIUMBLOB、BLOB、LONGBLOB和VARBINARY |
说明
- 除上述罗列字段类型外,其他类型均不支持。
- HybridDB for MySQL Reader插件将tinyint(1)视作整型。
数据同步任务开发
HybridDB for MySQL数据同步任务的配置入口和通用配置流程指导可参见下文的配置指导,详细的配置参数解释可在配置界面查看对应参数的文案提示。
创建数据源
在进行数据同步任务开发时,您需要在DataWorks上创建一个对应的数据源,操作流程请参见创建与管理数据源。
单表离线同步任务配置指导
- 操作流程请参见通过向导模式配置离线同步任务、通过脚本模式配置离线同步任务。
- 脚本模式配置的全量参数和脚本Demo请参见下文的附录:脚本Demo与参数说明。
整库离线读同步配置指导
操作流程请参见数据集成侧同步任务配置。
附录:脚本Demo与参数说明
附录:离线任务脚本配置方式
如果您配置离线任务时使用脚本模式的方式进行配置,您需要在任务脚本中按照脚本的统一格式要求编写脚本中的reader参数和writer参数,脚本模式的统一要求请参见通过脚本模式配置离线同步任务,以下为您介绍脚本模式下的数据源的Reader参数和Writer参数的指导详情。
Reader脚本Demo
单库单表的脚本样例如下:
{
"type": "job",
"steps": [
{
"parameter": {
"datasource": "px_aliyun_hymysql",//数据源名。
"column": [//源端列名。
"id",
"name",
"sex",
"salary",
"age",
"pt"
],
"where": "id=10001",//过滤条件。
"splitPk": "id",//切分键。
"table": "person"//源端表名。
},
"name": "Reader",
"category": "reader"
},
{
"parameter": {}
],
"version": "2.0",//版本号。
"order": {
"hops": [
{
"from": "Reader",
"to": "Writer"
}
]
},
"setting": {
"errorLimit": {//错误记录数。
"record": ""
},
"speed": {
"concurrent": 7,//并发数。
"throttle": true,//当throttle值为false时,mbps参数不生效,表示不限流;当throttle值为true时,表示限流。
"mbps": 1 //限流值。
}
}
}
Reader脚本参数
参数 | 描述 | 是否必选 | 默认值 |
---|---|---|---|
datasource | 数据源名称,脚本模式支持添加数据源,此配置项填写的内容必须要与添加的数据源名称保持一致。 | 是 | 无 |
table | 选取的需要同步的表名称,一个数据集成任务只能同步数据到一个目的表。 | 是 | 无 |
column | 所配置的表中需要同步的列名集合,使用JSON的数组描述字段信息 。默认使用所有列配置,例如[*]。
| 是 | 无 |
splitPk | HybridDB for MySQL Reader进行数据抽取时,如果指定splitPk,表示您希望使用splitPk代表的字段进行数据分片,数据同步因此会启动并发任务进行数据同步,从而提高数据同步的效能。
| 否 | 无 |
where | 筛选条件,在实际业务场景中,往往会选择当天的数据进行同步,将where条件指定为gmt_create>$bizdate 。
| 否 | 无 |
querySql(高级模式,向导模式不提供) | 在部分业务场景中,where配置项不足以描述所筛选的条件,您可以通过该配置型来自定义筛选SQL 。当配置此项后,数据同步系统就会忽略column、table和where配置项,直接使用该项配置的内容对数据进行筛选。例如需要进行多表join后同步数据,使用[“id”,“table”,“1”,“‘mingya.wmy’”,“‘null’”,“to_char(a+1)”,“2.3”,“true”] 。当您配置querySql时,HybridDB for MySQL Reader直接忽略column、table和where和splitPk条件的配置,querySql优先级大于table、column、where、splitPk选项。datasource会使用它解析出用户名和密码等信息。 | 否 | 无 |
singleOrMulti(只适合分库分表) | 表示分库分表,向导模式转换成脚本模式主动生成此配置“singleOrMulti”:“multi” ,但配置脚本任务模板不会直接生成此配置,您需要手动添加,否则只会识别第一个数据源。singleOrMulti只是前端在用,后端没有用这个进行分库分表判断。 | 是 | multi |
Writer脚本Demo
{
"type": "job",
"steps": [
{
"parameter": {},
{
"parameter": {
"postSql": [],//导入后的完整语句。
"datasource": "px_aliyun_hy***",//数据源名。
"column": [//目标端列名。
"id",
"name",
"sex",
"salary",
"age",
"pt"
],
"writeMode": "insert",//写入模式。
"batchSize": 256,//一次性批量提交的记录数大小。
"encoding": "UTF-8",//编码格式。
"table": "person_copy",//目标表名。
"preSql": []//导入前的准备语句。
},
"name": "Writer",
"category": "writer"
}
],
"version": "2.0",//版本号。
"order": {
"hops": [
{
"from": "Reader",
"to": "Writer"
}
]
},
"setting": {
"errorLimit": {//错误记录数。
"record": ""
},
"speed": {
"concurrent": 7,//并发数。
"throttle": true,//当throttle值为false时,mbps参数不生效,表示不限流;当throttle值为true时,表示限流。
"mbps": 1,//限流值。
}
}
}
Writer脚本参数
参数 | 描述 | 是否必选 | 默认值 |
---|---|---|---|
datasource | 数据源名称,脚本模式支持添加数据源,此配置项填写的内容必须与添加的数据源名称保持一致。 | 是 | 无 |
table | 选取的需要同步的表名称。 | 是 | 无 |
writeMode | 选择导入模式,目前支持insert和replace两种方式。
| 否 | insert |
column | 目标表需要写入数据的字段,字段之间用英文逗号分隔。例如"column":["id","name","age"] 。如果要依次写入全部列,使用*表示,例如"column":["*"] 。 | 是 | 无 |
preSql | 执行数据同步任务之前率先执行的SQL语句。目前向导模式仅允许执行一条SQL语句,脚本模式可以支持多条SQL语句,例如清除旧数据。 | 否 | 无 |
postSql | 执行数据同步任务之后执行的SQL语句,目前向导模式仅允许执行一条SQL语句,脚本模式可以支持多条SQL语句,例如加上某一个时间戳。 | 否 | 无 |
batchSize | 一次性批量提交的记录数大小,该值可以极大减少数据同步系统与HybridDB for MySQL的网络交互次数,并提升整体吞吐量。如果该值设置过大,会导致数据同步运行进程OOM异常。 | 否 | 1,024 |