跳到主要内容

启动数据对比任务

启动指定的数据对比任务,并可为本次执行传入高级对比参数。

请求地址:/openapi/v1/comparedata/execute

请求方法:POST

调用前准备

taskId 可通过 创建数据对比任务 的成功响应 data 获取。启动成功后,如果需要继续查询本次执行的详情,可使用响应中的 data 作为 execId 调用 查询数据对比子任务详情

请求参数

参数类型是否必填说明示例
taskIdString需要启动的对比任务 ID。cd-tepmjmnj6o
compareOptionJSON本次执行的高级对比配置对象。需要自定义并发数、精度或字符串空格处理策略时传入。见下方示例

compareOption 字段说明

参数类型说明示例
parallelInteger对比并发数。5
splitNumString单次拆分处理的数据量。1000
differSizeString不一致记录的存储上限。1000
floatPrecisionStringfloat 类型字段的精度设置。3
doublePrecisionStringdouble 类型字段的精度设置。4
stringTrimStrategyString字符串空格处理策略。LTrim 表示去掉左侧空格,RTrim 表示去掉右侧空格,Trim 表示去掉两侧空格。Trim
enabledBoolean是否启用高级配置。设置为 true 时,按 compareOption 中的值执行。true

如何使用返回值

成功响应中的 data 为本次启动生成的 execId。后续调用 查询数据对比子任务详情 时,需要传入该值。

请求示例

{
"taskId": "cd-tepmjmnj6o",
"compareOption": {
"parallel": 5,
"splitNum": "1000",
"differSize": "1000",
"floatPrecision": "3",
"doublePrecision": "4",
"stringTrimStrategy": "Trim",
"enabled": true
}
}

返回参数

参数类型说明示例
successBoolean请求是否成功。true
requestIdString请求 ID,可用于问题排查和链路追踪。Ss1d8KLP-jppqeSZnkkrr3TWdlmc7PAK
dataInteger本次启动生成的子任务执行 ID,即 execId315337

调用成功示例

{
"success": true,
"requestId": "Ss1d8KLP-jppqeSZnkkrr3TWdlmc7PAK",
"data": 315337
}