# 查询数据级表对比任务列表 - ListDataLevelTableCompareJobs #### 功能介绍 查询数据级表对比任务列表。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-drs/drs_api_0035.html)。 #### URI GET /v3/{project_id}/jobs/{job_id}/table/compare 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-drs/drs_api_0106.html)。 | | job_id | 是 | String | 任务ID。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 任务数量。 | 表5compare_jobs字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 对比任务ID。 | | type | String | 对比类型。 - lines：行数对比 - contents：内容对比 - random：抽样对比，当前仅支持GaussDB分布式到GaussDB分布、GaussDB分布式到PostgreSQL、GaussDB集中式到PostgreSQL同步链路。 | | options | Map\ | 对比配置项，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\ | 对比任务的标签，当前仅涉及对比策略时返回。 | | proportion_value | String | 抽样比例，对比类型为抽样对比时填写。 | | database_info | Object | 当前对比任务进行对比时的业务/灾备数据库信息。 详情请参见[表6]。 | 表6database_info字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | service_database | String | 业务数据库信息。 | | disaster_recovery_database | 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， "database_info" : { "service_database" : "192.168.1.144:3306", "disaster_recovery_database" : "192.168.1.145:3306" } }, { "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 | 其他状态请参见[状态码](https://support.huaweicloud.com/api-drs/drs_api_0108.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-drs/drs_05_0004.html)。