调用GetErrorRequestSample接口,异步查询数据库实例SQL洞察结果中执行错误的SQL样本数据,最多返回指定时间范围内20条数据。

说明 异步调用后不会立即返回完整结果,当返回数据中isFinish取值为false时,请等待1s后重新发起调用,直到isFinish取值为true时,返回完整结果。
  • 目前仅支持RDS MySQL和PolarDB MySQL实例,请确保在使用该接口前,该实例已经开启DAS专业版,具体请参见购买DAS专业版
  • 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String GetErrorRequestSample

系统规定参数。取值:GetErrorRequestSample

InstanceId String rm-2ze8g2am97624****

实例ID。

NodeId String pi-bp179lg03445l****

节点ID。

说明 对于PolarDB MySQL实例,需要提供节点ID。
SqlId String 2cd4432556c3dab9d825ba363637****

SQL ID,您可以调用GetAsyncErrorRequestListByCode接口查询实例中产生MySQL错误码的SQL ID。

Start Long 1642556990714

查询开始时间,格式为Unix时间戳,单位为毫秒。

说明 查询开始时间需在数据库实例SQL洞察存储时长范围内,最大不能早于当前时间90天。
End Long 1642566830000

查询结束时间,格式为Unix时间戳,单位为毫秒。

说明 查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能超过1天。
DbName String testdb01

数据库名称。

返回数据

名称 类型 示例值 描述
Code Long 200

返回的状态码。

Message String Successful

请求返回消息。

说明 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。
Data Array of sample

返回的数据。

sqlId String 2cd4432556c3dab9d825ba363637****

SQL ID。

database String dbgateway

数据库名。

originHost String 172.16.1****

执行SQL的客户端IP地址。

tables Array of String meter_****

表名。

instanceId String rm-2ze8g2am97624****

实例ID。

errorCode String 1062

错误码。

user String dbgat****

数据库用户名。

sql String insert into meter_****

SQL语句。

timestamp Long 1644476100435

执行时间,格式为Unix时间戳,单位为毫秒。

RequestId String 7172BECE-588A-5961-8126-C216E16B****

请求的ID。

Success Boolean true

请求是否执行成功:

  • true:执行成功。
  • false:执行失败。

示例

请求示例

http(s)://das.cn-shanghai.aliyuncs.com/?Action=GetErrorRequestSample
&InstanceId=rm-2ze8g2am97624****
&SqlId=2cd4432556c3dab9d825ba363637****
&Start=1642556990714
&End=1642566830000
&DbName=testdb01
&公共请求参数

正常返回示例

XML格式

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

<GetErrorRequestSampleResponse>
    <Code>200</Code>
    <Message>Successful</Message>
    <Data>
        <sqlId>2cd4432556c3dab9d825ba363637****</sqlId>
        <database>dbgateway</database>
        <originHost>172.16.1****</originHost>
        <tables>meter_****</tables>
        <instanceId>rm-2ze8g2am97624****</instanceId>
        <errorCode>1062</errorCode>
        <user>dbgat****</user>
        <sql>insert into meter_****</sql>
        <timestamp>1644476100435</timestamp>
    </Data>
    <RequestId>7172BECE-588A-5961-8126-C216E16B****</RequestId>
    <Success>true</Success>
</GetErrorRequestSampleResponse>

JSON格式

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

{
  "Code" : 200,
  "Message" : "Successful",
  "Data" : {
    "sqlId" : "2cd4432556c3dab9d825ba363637****",
    "database" : "dbgateway",
    "originHost" : "172.16.1****",
    "tables" : "meter_****",
    "instanceId" : "rm-2ze8g2am97624****",
    "errorCode" : 1062,
    "user" : "dbgat****",
    "sql" : "insert into meter_****",
    "timestamp" : 1644476100435
  },
  "RequestId" : "7172BECE-588A-5961-8126-C216E16B****",
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams The request parameters are invalid. 请求参数错误

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