跳到主要内容

查询数据对比主任务详情

查询指定数据对比主任务的配置和最近一次执行信息。

请求地址：/openapi/v1/comparedata/queryTaskById

请求方法：GET

调用前准备​

taskId 可通过 创建数据对比任务 的成功响应 data 获取。

请求参数​

参数类型是否必填说明示例
taskIdString是需要查询的对比任务 ID。通常来自 创建数据对比任务 的成功响应 data。cd-tepmjmnj6o

如何使用返回值​

响应中的 data.id 就是当前任务的 taskId，可继续用于 停止数据对比任务 和 删除数据对比任务。data.lastExecId 可直接作为 查询数据对比子任务详情 的 execId。

请求示例​

{
  "taskId": "cd-tepmjmnj6o"
}

返回参数​

参数类型说明示例
successBoolean请求是否成功。true
requestIdString请求 ID，可用于问题排查和链路追踪。Hs1z8TSZ-jppqeJUnkkrg5BNdlnx3OSO
dataObject主任务详情对象。见下方字段说明

主任务字段说明​

参数类型说明示例
idString对比任务 ID，与请求中的 taskId 一致。cd-tepmjmnj6o
lastExecIdString最近一次执行生成的子任务 ID，可用于查询子任务详情。315337
statusString任务状态。success 表示已完成，failed 表示失败，starting 表示启动中，running 表示运行中。starting
nameString任务名称。compare-docx-proof-20260508163538
isDeletedBoolean是否处于删除状态。false
errMsgString错误信息。任务失败或异常时通常会返回具体内容。""

调用成功示例​

{
  "success": true,
  "requestId": "Hs1z8TSZ-jppqeJUnkkrg5BNdlnx3OSO",
  "data": {
    "id": "cd-tepmjmnj6o",
    "lastExecId": 315337,
    "type": "data",
    "sourceDsId": "ds-ct192k3jlj4f",
    "targetDsId": "ds-d37s953l33d3",
    "status": "starting",
    "objectConfig": {
      "all": false,
      "databaseList": [
        {
          "databaseName": "9zdbtest2",
          "targetDatabase": "9zdbtest3",
          "all": true,
          "tableList": [
            {
              "tableName": "sbtest1",
              "targetTable": "sbtest1"
            },
            {
              "tableName": "sbtest2",
              "targetTable": "sbtest2"
            }
          ]
        }
      ]
    },
    "createTime": "2026-05-08 08:35:38Z",
    "name": "compare-docx-proof-20260508163538",
    "isDeleted": false,
    "errMsg": "",
    "sourceDsName": "sqldev-13375",
    "targetDsName": "13376",
    "compareOption": {
      "parallel": 5,
      "splitNum": "1000",
      "differSize": "1000",
      "floatPrecision": "3",
      "doublePrecision": "4",
      "stringTrimStrategy": "Trim",
      "enabled": true
    }
  }
}