更新时间:2024-05-27 GMT+08:00

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

功能介绍

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

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

错误码

请参见错误码