查询校验任务不一致信息 - 数据传输服务 DTS

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeDataCheckTableDiffDetails	系统规定参数。取值：DescribeDataCheckTableDiffDetails。
CheckType	Integer	是	2	数据校验方式，取值： 1：全量校验。 2：增量校验。
DbName	String	是	db_dtstest	存在不一致数据的表所在的数据库的名称。
TbName	String	是	test_person	存在不一致数据的表名。
PageSize	Long	否	10	每页记录数。
PageNumber	Long	否	1	页码，取值为大于0且不超过Integer数据类型的最大值，默认值为1。
DtsJobId	String	是	xd4e4xb419q****	迁移或同步任务ID，您可以调用 DescribeDtsJobs接口查询。

返回数据


名称	类型	示例值	描述
RequestId	String	621BB4F8-3016-4FAA-8D5A-5D3163CC****	请求ID。
HttpStatusCode	Integer	200	状态码。
ErrCode	String	InvalidParameter	调用出错时返回的错误码。
Success	Boolean	true	请求是否成功。
ErrMessage	String	The value of the parameter tbName is invalid.	调用错误时返回的错误信息。
DynamicMessage	String	Type	动态错误信息，用于替换返回参数ErrMessage错误信息中的%s。说明如果ErrMessage返回The Value of Input Parameter %s is not valid，且DynamicMessage返回Type，则代表所传入的请求参数Type不合法。
TbName	String	test_person	源库中存在不一致数据的表名。
DbName	String	db_dtstest	源库中存在不一致数据的表所在的数据库名称。
DiffDetails	Array of DiffDetails		不一致信息。
Id	Long	13058****	用于标识一条校验结果数据的自增主键。
GmtCreated	String	2023-04-23T10:36:05.000+00:00	执行校验的时间。
Diff	String	[ { "column": "id", "source": "9511", "dest": "9511", "isPrimary": true }, { "column": "state", "source": "3", "dest": "2", "isPrimary": false }, { "column": "create_time", "source": "2023-04-11 14:07:17.0", "dest": "NULL", "isPrimary": false }, { "column": "update_time", "source": "2023-04-11 06:07:17.0", "dest": "2023-04-11 06:02:29.0", "isPrimary": false } ]	具体不一致信息，是一个JSON字符串。 column：字段名称。 source：源库中的值。 dest：目标库中的值。 isPrimary：字段是否是主键。
DiffCount	Long	1	数据不一致的行数。
InstanceId	String	dtsog8q1z3tc9t****"	实例ID。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=DescribeDataCheckTableDiffDetails
&CheckType=2
&DbName=db_dtstest
&TbName=test_person
&DtsJobId=xd4e4xb419q****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDataCheckTableDiffDetailsResponse>
    <DiffDetails>
        <Diff>[{"column":"s_id","source":null,"dest":"9","isPrimary":true}]</Diff>
        <Id>130581999</Id>
        <GmtCreated>2023-04-23T10:36:05.000+00:00</GmtCreated>
    </DiffDetails>
    <RequestId>EE2EB5DA-1162-5FE6-AA61-DAED5E38****</RequestId>
    <InstanceId>dtsnabt4g2r19q****</InstanceId>
    <HttpStatusCode>200</HttpStatusCode>
    <TbName>test_person</TbName>
    <DbName>db_dtstest</DbName>
    <DiffCount>1</DiffCount>
    <Success>true</Success>
</DescribeDataCheckTableDiffDetailsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DiffDetails" : [ {
    "Diff" : "[{\"column\":\"s_id\",\"source\":null,\"dest\":\"9\",\"isPrimary\":true}]",
    "Id" : 130581999,
    "GmtCreated" : "2023-04-23T10:36:05.000+00:00"
  } ],
  "RequestId" : "EE2EB5DA-1162-5FE6-AA61-DAED5E38****",
  "InstanceId" : "dtsnabt4g2r19q****",
  "HttpStatusCode" : 200,
  "TbName" : "test_person",
  "DbName" : "db_dtstest",
  "DiffCount" : 1,
  "Success" : true
}

错误码


HttpCode	错误码	错误信息	描述
400	Throttling.User	Request was denied due to user flow control.	由于请求频次达到阈值，请求被拒绝，请稍后重试。
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	由于服务端响应超时或者不可用导致请求失败，请重试，重试后仍失败请联系技术支持。
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	签名已经过期，请更新签名

访问错误中心查看更多错误码。