查询结构对比主任务详情
查询指定结构对比主任务的基本信息和最近一次执行信息。
请求地址:/openapi/v1/compareschema/queryTaskById
请求方法:GET
调用前准备
taskId 可通过 创建结构对比任务 的成功响应 data.taskId 获取,也可以通过 查询结构对比任务列表 返回的 data.schemaComparisons[].taskId 获取。
请求参数
| 参数 | 类型 | 是否必填 | 说明 | 示例 |
|---|---|---|---|---|
| taskId | String | 是 | 结构对比主任务 ID。 | cc-th6j3fs58y |
如何使用返回值
响应中的 data.lastExecId 是最近一次结构对比子任务 ID,可用于 查询结构对比子任务详情、查询结构对比对象结果 和 查询结构对比订正 SQL。
返回参数
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| success | Boolean | 请求是否成功。 | true |
| requestId | String | 请求 ID,可用于问题排查和链路追踪。 | Jf5c0IKB-bhicqBRndhhr5TEdchr4BRP |
| data | Object | 结构对比主任务详情,字段见下方说明。 | 见下方示例 |
| message | String | 错误信息。请求失败时返回。 | task not found |
data 字段说明
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| taskId | String | 结构对比主任务 ID。 | cc-th6j3fs58y |
| lastExecId | Long | 最近一次结构对比子任务 ID。 | 46958 |
| status | String | 任务状态。常见取值包括 success、failed、starting、running。 | starting |
| name | String | 任务名称。 | schema_compare_demo |
| isDeleted | Boolean | 是否处于删除状态。 | false |
| errMsg | String | 错误信息。任务失败或异常时返回。 | "" |
请求示例
{
"taskId": "cc-th6j3fs58y"
}
调用成功示例
{
"success": true,
"requestId": "Jf5c0IKB-bhicqBRndhhr5TEdchr4BRP",
"data": {
"taskId": "cc-th6j3fs58y",
"lastExecId": 46958,
"status": "starting",
"name": "schema_compare_demo",
"isDeleted": false
}
}