任务配置

一个采集任务就是一个 JSON 格式配置文件，该配置文件的模板如下：

{
  "job": {
    "settings": {},
    "content": {
      "reader": {},
      "writer": {},
      "transformer": []
    }
  }
}

任务配置由 key 为 job 的字典组成，其字典元素由三部分组成：

• settings: 用来定义本次任务的一些控制参数，比如指定多少线程，最大错误率，最大错误记录条数等，这是可选配置。
• reader: 用来配置数据读取所需要的相关信息，这是必填内容
• writer: 用来配置写入数据所需要的相关信息，这是必填内容
• transformer: 数据转换规则，如果需要对读取的数据在写入之前做一些变换，可以配置该项，否则可以不配置

reader 配置项

reader 配置项依据不同的 reader 插件而有些微不同，但大部分的配置大同小异，特别是针对关系型数据库而言，其基本配置如下：

{
  "name": "mysqlreader",
  "parameter": {
    "username": "",
    "password": "",
    "column": [],
    "connection": [
      {
        "jdbcUrl": [],
        "table": []
      }
    ],
    "where": ""
  }
}

其中 name 是插件的名称，每个插件的名称都是唯一的，每个插件更详细的配置可以参考读取插件章节的各插件内容

writer 配置项

writer 配置项和 reader 配置项差不多，其基本模板如下：

{
  "name": "mysqlwriter",
  "parameter": {
    "username": "",
    "password": "",
    "writeMode": "",
    "column": [],
    "session": [],
    "preSql": [],
    "connection": [
      {
        "jdbcUrl": "",
        "table": []
      }
    ]
  }
}

同样的，这里的 name 也是唯一的，每个插件更详细的配置可以参考写入插件章节的各插件内容

settings 配置项

settings 可配置的内容如下：

{
  "setting": {
    "speed": {
      "byte": -1,
      "record": 100,
      "channel": 1
    },
    "errorLimit": {
      "record": 0,
      "percentage": 0.02
    }
  }
}

解释如下：

speed

顾名思义，这里是用来做流控的配置项，可以从网络传输速度，每秒的记录数以及线程数上做控制，分别描述如下：

speed.byte

设置每秒可获取的字节数(Bps)，一般是为了防止执行任务时将整个带宽跑满，从而影响到其他服务。如果不做限制，可设置为 -1

speed.record

设置记录每秒可获取的最大记录条数，该参数需要和 speed.byte 配合使用

speed.channel

设置通道数，该通道路确定了每个任务的线程数，目前一个channel对应5个线程，比如设置 channel 为 3， 则有 3 * 5 + 1 = 16 个线程，其中一个线程为统计线程。

errorLimit

errorLimit 用来配置在数据写入报错时的行为，具体如下

errorLimit.record

允许错误的记录条数，如果超过这个数，则认为本次任务失败，否则认为成功

errorLimit.percentage

允许错误记录的比率，超过这个比率，则认为本次任务失败，否则认为成功

注意，上述参数在 conf/core.json 配置文件均有默认配置，用来控制全局的设置。