查询结构对比对象结果

查询指定结构对比任务某次执行中的对象级对比结果，包括源端 DDL、目标端 DDL 和是否一致。

请求地址：/openapi/v1/compareschema/describeSchemaCompareTask

请求方法：GET

调用前准备

• taskId 可通过 创建结构对比任务 的成功响应 data.taskId 获取。
• execId 可通过 启动结构对比任务 的成功响应 data 或 查询结构对比主任务详情 返回的 data.lastExecId 获取。

请求参数

参数	类型	是否必填	说明	示例
taskId	String	是	结构对比主任务 ID。	cc-th6j3fs58y
execId	Long	是	结构对比子任务 ID。	46958
pageSize	Integer	否	每页记录数，默认为 30，最大为 100。	30
pageNumber	Integer	否	当前页码，默认从 1 开始。	1

返回参数

参数	类型	说明	示例
success	Boolean	请求是否成功。	true
requestId	String	请求 ID，可用于问题排查和链路追踪。	Lh9l2VRM-djkefYZnfjjt7MKdekw9FOC
data	Object	对象级对比结果分页对象，字段见下方说明。	见下方示例
message	String	错误信息。请求失败时返回。	exec not found

data 字段说明

参数	类型	说明	示例
taskId	String	结构对比主任务 ID。	cc-th6j3fs58y
execId	Long	结构对比子任务 ID。	46958
pageNum	Integer	当前页码。	1
pageSize	Integer	每页记录数。	30
total	Integer	对象结果总数。	1
compareResults	Array	对象级对比结果列表。	见下方字段说明

compareResults 字段说明

参数	类型	说明	示例
progressId	Integer	单个对象的结果标识，可用于查询订正 SQL。	388425
sourceDbName	String	源端对象所在的库名或 Schema 名。	9zdbtest2
sourceObjectName	String	源端对象名称。三层结构数据源可能返回 schema.table 格式。	sbtest1
targetDbName	String	目标端对象所在的库名或 Schema 名。	9zdbtest3
targetObjectName	String	目标端对象名称。三层结构数据源可能返回 schema.table 格式。	sbtest1
status	String	对象对比状态。取值包括 notstarted、running、failed、success。	success
compareResult	Boolean	对象结构是否一致。true 表示一致，false 表示不一致。	false
createTime	String	对象开始对比的时间。	2026-06-25 08:47:50Z
endTime	String	对象结束对比的时间。	2026-06-25 08:47:55Z
sourceDdl	String	源端对象 DDL。	CREATE TABLE ...
targetDdl	String	目标端对象 DDL。	CREATE TABLE ...

请求示例

{
  "taskId": "cc-th6j3fs58y",
  "execId": 46958,
  "pageNumber": 1,
  "pageSize": 30
}

调用成功示例

{
  "success": true,
  "requestId": "Lh9l2VRM-djkefYZnfjjt7MKdekw9FOC",
  "data": {
    "taskId": "cc-th6j3fs58y",
    "execId": 46958,
    "pageNum": 1,
    "pageSize": 30,
    "total": 1,
    "compareResults": [
      {
        "progressId": 388425,
        "sourceDbName": "9zdbtest2",
        "sourceObjectName": "sbtest1",
        "targetDbName": "9zdbtest3",
        "targetObjectName": "sbtest1",
        "status": "success",
        "compareResult": false,
        "sourceDdl": "CREATE TABLE `sbtest1` (...)",
        "targetDdl": ""
      }
    ]
  }
}