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

查询对象对比任务详情 - ListObejectLevelCompareDetail

功能介绍

查询对象对比任务详情。

授权信息

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

URI

GET /v3/{project_id}/jobs/{job_id}/object/compare/{compare_type}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。

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

job_id

是

String

任务ID。

compare_type

是

String

对象类型：

  • DB：数据库。
  • TABLE：表。
  • VIEW：视图。
  • EVENT：事件。
  • ROUTINE：存储过程和函数。
  • INDEX：索引。
  • TRIGGER：触发器。
  • SYNONYM：同义词。
  • FUNCTION：函数。
  • PROCEDURE：存储过程。
  • TYPE：自定义类型。
  • RULE：规则。
  • DEFAULT_TYPE：缺省值。
  • PLAN_GUIDE：执行计划。
  • CONSTRAINT：约束。
  • FILE_GROUP：文件组。
  • PARTITION_FUNCTION：分区函数。
  • PARTITION_SCHEME：分区方案。
  • TABLE_COLLATION：表的排序规则。
表2 Query参数

参数

是否必选

参数类型

描述

compare_job_id

否

String

对比任务ID，不填写时默认返回最新的对比任务信息。

limit

否

Integer

每页显示的条目数量，最大值1000。

最小值：1

最大值：1000

缺省值：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参数

参数

参数类型

描述

count

Integer

对比数量。

compare_detail

Array of objects

对象级对比详情。

详情请参见表5。

表5 compare_detail字段数据结构说明

参数

参数类型

描述

source_db_name

String

源库名称。

target_db_name

String

目标库名称。

source_db_value

String

在源库的值。

target_db_value

String

在目标库的值。

status

Integer

对比结果，0为不一致，2为一致，3为未完成。

error_message

String

错误信息。

请求示例

查询对象对比任务表对象对比详情。

https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/f8688cfa-4e05-406f-a2e6-37a773cjb20y/object/compare/TABLE

响应示例

状态码：200

OK

{
  "count" : 1,
  "compare_detail" : [ {
    "source_db_value" : "tb1",
    "target_db_value" : "tb1",
    "source_db_name" : "db1",
    "target_db_name" : "db1",
    "status" : 2
  } ]
}

状态码：400

Bad Request

{
  "error_code" : "DRS.10000010",
  "error_msg" : "Task not found. Check the task ID."
}

状态码

状态码

描述

200

OK

400

Bad Request

错误码

请参见错误码。

父主题：公共接口管理