调用GetErrorRequestSample接口,异步查询数据库实例SQL洞察结果中执行错误的SQL样本数据,最多返回指定时间范围内20条数据。
说明 异步调用后不会立即返回完整结果,当返回数据中isFinish取值为false时,请等待1s后重新发起调用,直到isFinish取值为true时,返回完整结果。
- 目前仅支持RDS MySQL和PolarDB MySQL实例,请确保在使用该接口前,该实例已经开启DAS专业版,具体请参见购买DAS专业版。
- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
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 |
请求是否执行成功:
|
示例
请求示例
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. | 请求参数错误 |
访问错误中心查看更多错误码。