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

查询行数对比详情

功能介绍

查询行数对比详情。

URI

GET /v3/{project_id}/jobs/{job_id}/compare/{compare_job_id}/line-detail

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。

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

job_id

是

String

任务ID。

compare_job_id

是

String

对比任务ID。
表2 Query参数

参数

是否必选

参数类型

描述

status

否

Integer

对比状态。

  • 0：对比不一致
  • 2：对比一致
  • 3：目标库表不存在
  • 4：对比失败
  • 5：正在对比中
  • 6：等待对比中
  • 7：任务已取消
  • 8：源库为空
  • 9：目标库为空
  • 10：源库和目标库都为空
  • 11：源表不存在
  • 12：目标表不存在
  • 13：原表和目标表都不存在
  • 14：源数据库连接失败
  • 15：目标库数据库连接失败
  • 16：源数据库执行SQL超时
  • 17：目标数据库执行SQL超时
  • 18：源数据库执行SQL错误
  • 19：目标数据库执行SQL错误
  • 20：源库和目标库都不存在
  • 21：源库不存在
  • 22：目标库不存在
  • 23：行数为亿行，未进行对比
  • 27：超时

type

否

String

类型。

  • compare：查询正常对比的项
  • unCompare：查询无法对比的项

db_name

否

String

源数据库名。

target_db_name

否

String

目标数据库名。

query_tb_name

否

String

表名过滤关键字。

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参数

参数

参数类型

描述

total_count

Integer

对比数量。

table_line_compare_result_infos

Array of objects

对比信息列表。

详情请参见表5。
表5 TableLineCompareResultInfo字段数据结构说明

参数

参数类型

描述

source_table_name

String

源库表名称

source_row_num

Long

源库表行数

target_table_name

String

目标库表名称

target_row_num

Long

目标库表行数

difference_row_num

Long

行数差异值

status

Integer

对比状态。

  • 0：对比不一致
  • 2：对比一致
  • 3：目标库表不存在
  • 4：对比失败
  • 5：正在对比中
  • 6：等待对比中
  • 7：任务已取消
  • 8：源库为空
  • 9：目标库为空
  • 10：源库和目标库都为空
  • 11：源表不存在
  • 12：目标表不存在
  • 13：原表和目标表都不存在
  • 14：源数据库连接失败
  • 15：目标库数据库连接失败
  • 16：源数据库执行SQL超时
  • 17：目标数据库执行SQL超时
  • 18：源数据库执行SQL错误
  • 19：目标数据库执行SQL错误
  • 20：源库和目标库都不存在
  • 21：源库不存在
  • 22：目标库不存在
  • 23：行数为亿行，未进行对比
  • 27：超时

compare_line_config_filter

String

行过滤配置条件

请求示例

查询行数对比详情

https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/f8688cfa-4e05-406f-a2e6-37a773cjb20y/table/compare/48c6acb4-1473-48fd-8676-df3705758c27/line-detail?offset=0&limit=10

响应示例

状态码： 200

OK

{
  "total_count" : 2,
  "table_line_compare_result_infos" : [ {
    "source_table_name" : "tb2",
    "source_row_num" : 2434882,
    "target_table_name" : "tb2",
    "target_row_num" : 2434882,
    "difference_row_num" : 0,
    "status" : 2
  }, {
    "source_table_name" : "tb1",
    "source_row_num" : 1,
    "target_table_name" : "tb1",
    "target_row_num" : 1,
    "difference_row_num" : 0,
    "status" : 2
  } ]
}

状态码： 400

Bad Request

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

状态码

状态码

描述

200

OK

400

Bad Request

错误码

请参见错误码。

父主题： 公共接口管理

相关文档