跳到主要内容

查询结构对比主任务详情

查询指定结构对比主任务的基本信息和最近一次执行信息。

请求地址:/openapi/v1/compareschema/queryTaskById

请求方法:GET

调用前准备

taskId 可通过 创建结构对比任务 的成功响应 data.taskId 获取,也可以通过 查询结构对比任务列表 返回的 data.schemaComparisons[].taskId 获取。

请求参数

参数类型是否必填说明示例
taskIdString结构对比主任务 ID。cc-th6j3fs58y

如何使用返回值

响应中的 data.lastExecId 是最近一次结构对比子任务 ID,可用于 查询结构对比子任务详情查询结构对比对象结果查询结构对比订正 SQL

返回参数

参数类型说明示例
successBoolean请求是否成功。true
requestIdString请求 ID,可用于问题排查和链路追踪。Jf5c0IKB-bhicqBRndhhr5TEdchr4BRP
dataObject结构对比主任务详情,字段见下方说明。见下方示例
messageString错误信息。请求失败时返回。task not found

data 字段说明

参数类型说明示例
taskIdString结构对比主任务 ID。cc-th6j3fs58y
lastExecIdLong最近一次结构对比子任务 ID。46958
statusString任务状态。常见取值包括 successfailedstartingrunningstarting
nameString任务名称。schema_compare_demo
isDeletedBoolean是否处于删除状态。false
errMsgString错误信息。任务失败或异常时返回。""

请求示例

{
"taskId": "cc-th6j3fs58y"
}

调用成功示例

{
"success": true,
"requestId": "Jf5c0IKB-bhicqBRndhhr5TEdchr4BRP",
"data": {
"taskId": "cc-th6j3fs58y",
"lastExecId": 46958,
"status": "starting",
"name": "schema_compare_demo",
"isDeleted": false
}
}