查询数据对比预检查状态

查询指定数据对比任务的预检查执行状态和检查项结果。

请求地址：/openapi/v1/comparedata/precheck/status

请求方法：GET

调用前准备

• taskId 可通过 创建数据对比任务 的成功响应 data 获取。
• precheckTaskId 可通过 启动数据对比预检查 的成功响应 data.precheckTaskId 获取。

请求参数

参数	类型	是否必填	说明	示例
taskId	String	是	需要查询预检查状态的数据对比任务 ID。	cd-tg3isu1xgs
precheckTaskId	String	是	需要查询的预检查任务 ID。	pcte-dj02vti9tabd

返回参数

参数	类型	说明	示例
success	Boolean	请求是否成功。	true
requestId	String	请求 ID，可用于问题排查和链路追踪。	Lu8t2KPM-eqqraVGnllse6BZdmnh5DQM
data	Object	预检查状态对象。	见下方字段说明

data 字段说明

参数	类型	说明	示例
taskId	String	数据对比任务 ID。	cd-tg3isu1xgs
precheckTaskId	String	预检查任务 ID。	pcte-dj02vti9tabd
status	String	预检查任务状态。取值包括：Unstarted、Running、Failed、Success。	Success
precheckItems	Array	预检查项列表，包含每个检查项的执行状态、失败原因和修复建议。	见下方字段说明

precheckItems 字段说明

参数	类型	说明	示例
precheckItem	String	检查项标识。	targetDataExistCheck
status	String	检查项状态。取值包括：Unstarted、Running、Failed、Success。	Success
errorMessage	String	检查项失败时返回的原因和修复建议。	目标存在如下表，没有包含字段：_sign 及 _version，请为这些表添加字段后重新预检查
itemName	String	检查项名称。	Source database privilege check
itemDescription	String	检查项描述。	Check whether the account privileges of the source database meet the requirements

请求示例

{
  "taskId": "cd-tg3isu1xgs",
  "precheckTaskId": "pcte-dj02vti9tabd"
}

调用成功示例

{
  "success": true,
  "requestId": "Lu8t2KPM-eqqraVGnllse6BZdmnh5DQM",
  "data": {
    "taskId": "cd-tg3isu1xgs",
    "precheckTaskId": "pcte-dj02vti9tabd",
    "status": "Success",
    "precheckItems": [
      {
        "precheckItem": "compareSrcPermissionCheck",
        "itemName": "Source database privilege check",
        "itemDescription": "Check whether the account privileges of the source database meet the requirements",
        "status": "Success"
      },
      {
        "precheckItem": "targetDataSourceCheck",
        "itemName": "Target Connection Check",
        "itemDescription": "Check the status of the gateway of the target datasource, database connectable, and verify the username and password",
        "status": "Success"
      }
    ]
  }
}