启动数据对比任务
启动指定的数据对比任务,并可为本次执行传入高级对比参数。
请求地址:/openapi/v1/comparedata/execute
请求方法:POST
调用前准备
taskId 可通过 创建数据对比任务 的成功响应 data 获取。启动成功后,如果需要继续查询本次执行的详情,可使用响应中的 data 作为 execId 调用 查询数据对比子任务详情。
请求参数
| 参数 | 类型 | 是否必填 | 说明 | 示例 |
|---|---|---|---|---|
| taskId | String | 是 | 需要启动的对比任务 ID。 | cd-tepmjmnj6o |
| compareOption | JSON | 否 | 本次执行的高级对比配置对象。需要自定义并发数、精度或字符串空格处理策略时传入。 | 见下方示例 |
compareOption 字段说明
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| parallel | Integer | 对比并发数。 | 5 |
| splitNum | String | 单次拆分处理的数据量。 | 1000 |
| differSize | String | 不一致记录的存储上限。 | 1000 |
| floatPrecision | String | float 类型字段的精度设置。 | 3 |
| doublePrecision | String | double 类型字段的精度设置。 | 4 |
| stringTrimStrategy | String | 字符串空格处理策略。LTrim 表示去掉左侧空格,RTrim 表示去掉右侧空格,Trim 表示去掉两侧空格。 | Trim |
| enabled | Boolean | 是否启用高级配置。设置为 true 时,按 compareOption 中的值执行。 | true |
如何使用返回值
成功响应中的 data 为本次启动生成的 execId。后续调用 查询数据对比子任务详情 时,需要传入该值。
请求示例
{
"taskId": "cd-tepmjmnj6o",
"compareOption": {
"parallel": 5,
"splitNum": "1000",
"differSize": "1000",
"floatPrecision": "3",
"doublePrecision": "4",
"stringTrimStrategy": "Trim",
"enabled": true
}
}
返回参数
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| success | Boolean | 请求是否成功。 | true |
| requestId | String | 请求 ID,可用于问题排查和链路追踪。 | Ss1d8KLP-jppqeSZnkkrr3TWdlmc7PAK |
| data | Integer | 本次启动生成的子任务执行 ID,即 execId。 | 315337 |
调用成功示例
{
"success": true,
"requestId": "Ss1d8KLP-jppqeSZnkkrr3TWdlmc7PAK",
"data": 315337
}