文档首页/ 数据复制服务 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-overview

表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：超时

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

对比信息数量。

data_compare_overview_infos

Array of objects

信息列表。

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

参数

参数类型

描述

source_db_name

String

源库库名。

target_db_name

String

目标库库名。

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_num

Integer

总表数。

compare_end_num

Integer

已完成表数。

data_inconsistent_num

Integer

不一致表数。

uncomparable_num

Integer

无法对比表数。

请求示例

查询行数对比总览

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

响应示例

状态码： 200

OK

{
  "total_count" : 1,
  "data_compare_overview_infos" : [ {
    "status" : 2,
    "source_db_name" : "my_db",
    "target_db_name" : "my_db",
    "compare_num" : 16,
    "compare_end_num" : 16,
    "data_inconsistent_num" : 0,
    "uncomparable_num" : 0
  } ]
}

  
状态码： 400

  
Bad Request

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

 

 

  
状态码

  

   

    
     

      
       
状态码

      
       
描述

     

    
    
     

      
       
200

      
       
OK

     

     

      
       
400

      
       
Bad Request

     

    
   

  

 

 

  
错误码

  
请参见错误码。

 





 

  

   父主题： 公共接口管理
  

 



      
    
  

  
  
  

  
  
  

    
    

      
相关文档