文档首页/ 数据复制服务 DRS/ API参考/ API v3（不再推广）/ 公共接口管理/ 查询数据级表对比任务列表 - ListDataLevelTableCompareJobs
更新时间：2026-02-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询数据级表对比任务列表 - ListDataLevelTableCompareJobs

功能介绍

查询数据级表对比任务列表。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v3/{project_id}/jobs/{job_id}/table/compare

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。

获取方法请参见获取项目ID。

job_id

是

String

任务ID。
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

每页显示的条目数量。

缺省值：1000

offset

否

Integer

偏移量，表示从此偏移量开始查询， offset大于等于0。

缺省值：0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

指定类型为application/json。

缺省值：application/json

X-Auth-Token

是

String

从IAM服务获取的用户Token。

X-Language

否

String

请求语言类型。

缺省值：en-us

枚举值：

  • en-us
  • zh-cn

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

compare_jobs

Array of objects

表对比任务信息。

详情请参见表5。

count

Long

任务数量。
表5 compare_jobs字段数据结构说明

参数

参数类型

描述

id

String

对比任务ID。

type

String

对比类型。

  • lines：行数对比
  • contents：内容对比
  • random：抽样对比，当前仅支持GaussDB分布式到GaussDB分布、GaussDB分布式到PostgreSQL、GaussDB集中式到PostgreSQL同步链路。

options

Map<String,String>

对比配置项，key-value形式。 内容对比支持以下配置项：

  • 对比方式配置，key：contentCompareType，value：dynamic表示动态对比，static表示静态对比。
  • lob字段对比类型配置，key：lobCompare，value：ignore表示忽略，length表示长度对比。

行数对比支持以下配置项：

  • 对比策略配置，多表归一情况下适用，key：comparePolicy，value：normal表示正常对比，manyToOne表示多对一对比。

start_time

String

开始时间，UTC时间，例如：2020-09-01T18:50:20Z。

end_time

String

结束时间，UTC时间，例如：2020-09-01T18:50:20Z。

status

String

对比任务的状态。

  • RUNNING-运行中
  • WAITING_FOR_RUNNING-等待启动中
  • SUCCESSFUL-完成
  • FAILED-失败
  • CANCELLED-已取消
  • TIMEOUT_INTERRUPT-超时中断
  • FULL_DOING-全量校验中
  • INCRE_DOING-增量校验中

export_status

String

导出对比结果状态。

  • INIT：初始状态
  • EXPORTING：对比结果导出中
  • EXPORT_COMPLETE：对比结果导出完成
  • EXPORT_COMMON_FAILED：对比结果导出失败

report_remain_seconds

Long

导出比对结果有效期剩余时间。

compare_job_tag

Map<String,String>

对比任务的标签，当前仅涉及对比策略时返回。

proportion_value

String

抽样比例，对比类型为抽样对比时填写。

请求示例

查询数据级表对比任务列表

https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/{job_id}/table/compare?offset=0&limit=10

响应示例

状态码：200

OK

{
  "count" : 2,
  "compareJobs" : [ {
    "id" : "48c6acb4-1473-48fd-8676-df3705758c27",
    "type" : "lines",
    "options" : { },
    "status" : "SUCCESSFUL",
    "start_time" : "2024-03-14T06:30:14Z",
    "end_time" : "2024-03-14T06:31:14Z",
    "export_status" : "INIT",
    "report_remain_seconds" : -1
  }, {
    "id" : "9e01bd96-e627-4538-a545-5f31d1c88e94",
    "type" : "lines",
    "options" : { },
    "status" : "SUCCESSFUL",
    "start_time" : "2024-03-14T06:30:14Z",
    "end_time" : "2024-03-14T06:31:14Z",
    "export_status" : "INIT",
    "report_remain_seconds" : -1,
    "proportion_value" : "1"
  } ]
}

状态码：400

Bad Request

{
  "error_code" : "DRS.M00202",
  "error_msg" : "The value of jobId is invalid."
}

状态码

状态码

描述

200

OK

400

Bad Request

错误码

请参见错误码。

父主题： 公共接口管理

相关文档