一个完整的Flinkx任务脚本配置包含 content, setting两个部分。content用于配置任务的输入源与输出源,其中包含reader,writer。而setting则配置任务整体的环境设定,其中包含restore,speed,errorLimit,dirty,log。具体如下所示:
{
"job" : {
"content" :[{
"reader" : {
},
"writer" : {
}
}],
"setting" : {
"restore" : {
},
"speed" : {
},
"dirty" : {
},
"log" : {
}
}
}
}
名称 | 说明 | 是否必填 | |
---|---|---|---|
content | reader | reader插件详细配置 | 是 |
writer | writer插件详细配置 | 是 | |
setting | restore | 任务类型及断点续传配置 | 否 |
speed | 速率限制 | 否 | |
errorLimit | 出错控制 | 否 | |
dirty | 脏数据保存 | 否 | |
log | 日志记录配置 | 否 |
reader用于配置数据的输入源,即数据从何而来。具体配置如下所示:
{
"reader" : {
"name" : "xxreader",
"parameter" : {
}
}
}
名称 | 说明 | 是否必填 |
---|---|---|
name | reader插件名称,具体名称参考各数据源配置文档 | 是 |
parameter | 数据源配置参数,具体配置参考各数据源配置文档 | 是 |
writer用于配置数据的输出源,即数据写往何处。具体配置如下所示:
{
"writer" : {
"name" : "xxwriter",
"parameter" : {
}
}
}
名称 | 说明 | 是否必填 |
---|---|---|
name | writer插件名称,具体名称参考各数据源配置文档 | 是 |
parameter | 数据源配置参数,具体配置参考各数据源配置文档 | 是 |
restore用于配置同步任务类型(离线同步、实时采集)和断点续传功能。具体配置如下所示:
{
"restore" : {
"isStream" : false,
"isRestore" : false,
"restoreColumnName" : "",
"restoreColumnIndex" : 0,
"maxRowNumForCheckpoint" : 10000
}
}
名称 | 说明 | 是否必填 | 默认值 | 参数类型 |
---|---|---|---|---|
isStream | 是否为实时采集任务 | 否 | false | Boolean |
isRestore | 是否开启断点续传 | 否 | false | Boolean |
restoreColumnName | 断点续传字段名称 | 开启断点续传后必填 | 无 | String |
restoreColumnIndex | 断点续传字段索引ID | 开启断点续传后必填 | -1 | int |
maxRowNumForCheckpoint | 触发checkpoint数据条数 | 否 | 10000 | int |
speed用于配置任务并发数及速率限制。具体配置如下所示:
{
"speed" : {
"channel": 1,
"bytes": 0
}
}
名称 | 说明 | 是否必填 | 默认值 | 参数类型 |
---|---|---|---|---|
channel | 任务并发数 | 否 | 1 | int |
bytes | bytes >0则表示开启任务限速 | 否 | Long.MAX_VALUE | Long |
errorLimit用于配置任务运行时数据读取写入的出错控制。具体配置如下所示:
{
"errorLimit" : {
"record": 100,
"percentage": 10.0
}
}
名称 | 说明 | 是否必填 | 默认值 | 参数类型 |
---|---|---|---|---|
record | 错误阈值,当错误记录数超过此阈值时任务失败 | 否 | 0 | int |
percentage | 错误比例阈值,当错误记录比例超过此阈值时任务失败 | 否 | 0.0 | Double |
dirty用于配置脏数据的保存,通常与上文出错控制联合使用。具体配置如下所示:
{
"dirty" : {
"path" : "xxx",
"hadoopConfig" : {
}
}
}
名称 | 说明 | 是否必填 | 默认值 | 参数类型 |
---|---|---|---|---|
path | 脏数据保存路径 | 是 | 无 | Sring |
hadoopConfig | Hadoop相关配置 | 是 | 无 | K-V键值对 |
参考模板如下:
{
"dirty" : {
"path" : "/user/hive/warehouse/xx.db/xx",
"hadoopConfig" : {
"fs.default.name": "hdfs://0.0.0.0:9000",
"dfs.ha.namenodes.ns1" : "nn1,nn2",
"dfs.namenode.rpc-address.ns1.nn1" : "0.0.0.0:9000",
"dfs.namenode.rpc-address.ns1.nn2" : "0.0.0.1:9000",
"dfs.client.failover.proxy.provider.ns1" : "org.apache.hadoop.hdfs.server.namenode.ha.ConfiguredFailoverProxyProvider",
"dfs.nameservices" : "ns1"
}
}
}
log用于配置Flinkx中定义的插件日志的保存与记录。具体配置如下所示:
{
"log" : {
"isLogger": false,
"level" : "info",
"path" : "/tmp/dtstack/flinkx/",
"pattern":""
}
}
名称 | 说明 | 是否必填 | 默认值 | 参数类型 |
---|---|---|---|---|
isLogger | 是否保存日志记录 | 否 | false | Boolean |
level | 日志级别 | 否 | info | String |
path | 服务器上日志保存路径 | 否 | /tmp/dtstack/flinkx/ | String |
pattern | 日志输出格式 | 否 | log4j:%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{60} %X{sourceThread} - %msg%n | String |
logback : %d{yyyy-MM-dd HH:mm:ss,SSS} %-5p %-60c %x - %m%n |