查询结构对比任务列表

查询当前账户下的结构对比任务列表，可按结构对比主任务 ID 精确查询。

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

请求方法：GET

请求参数

参数	类型	是否必填	说明	示例
taskId	String	否	结构对比主任务 ID。不传时按分页参数返回结构对比任务列表。	cc-th6j3fs58y
pageSize	Integer	否	每页记录数，默认为 30，最大为 100。	30
pageNumber	Integer	否	当前页码，默认从 1 开始。	1

返回参数

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

data 字段说明

参数	类型	说明	示例
pageNumber	Integer	当前页码。	1
pageSize	Integer	每页记录数。	30
total	Integer	符合条件的任务总数。	1
schemaComparisons	Array	结构对比任务列表。	见下方字段说明

schemaComparisons 字段说明

参数	类型	说明	示例
taskId	String	结构对比任务 ID。	cc-th6j3fs58y
taskName	String	结构对比任务名称。	schema_compare_demo
status	String	任务状态。常见取值包括 notStarted、prechecking、starting、running、failed、success。	success
periodic	String	对比方式。ONETIME 表示一次性对比，PERIODIC 表示周期性对比。	ONETIME
lastExecId	Long	最近一次结构对比子任务 ID。	46958
createTime	String	任务创建时间。	2026-06-25 08:47:31Z
sourceDsId	String	源端数据源 ID。	ds-ct192k3jlj4f
sourceDsName	String	源端数据源名称。	sqldev-13375
sourceDsType	String	源端数据源类型。	mysql
targetDsId	String	目标端数据源 ID。	ds-d37s953l33d3
targetDsName	String	目标端数据源名称。	13376
targetDsType	String	目标端数据源类型。	mysql

请求示例

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

调用成功示例

{
  "success": true,
  "requestId": "Kg1z5GAI-gmnhsLLnimmh7TTdhmo7KGB",
  "data": {
    "pageNumber": 1,
    "pageSize": 30,
    "total": 1,
    "schemaComparisons": [
      {
        "taskId": "cc-th6j3fs58y",
        "taskName": "schema_compare_demo",
        "status": "success",
        "periodic": "ONETIME",
        "lastExecId": 46958,
        "createTime": "2026-06-25 08:47:31Z",
        "sourceDsId": "ds-ct192k3jlj4f",
        "sourceDsName": "sqldev-13375",
        "sourceDsType": "mysql",
        "targetDsId": "ds-d37s953l33d3",
        "targetDsName": "13376",
        "targetDsType": "mysql"
      }
    ]
  }
}