调用GetFullRequestSampleByInstanceId接口,按照SQL ID查询数据库实例SQL洞察结果中的SQL样本数据,最大返回20条样本数据。
SQL洞察功能可对SQL进行健康情况诊断、性能问题排查,详情请参见SQL洞察。
- 支持的数据库引擎请参见SQL洞察。
- 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetFullRequestSampleByInstanceId |
系统规定参数。取值:GetFullRequestSampleByInstanceId。 |
UserId | String | 否 | 196278346919**** |
用户ID,即创建数据库实例的阿里云主账号ID。 说明 非必填,输入目标数据库实例ID后,在调用API接口时,系统会自动获取用户ID。
|
InstanceId | String | 是 | rm-2ze8g2am97624**** |
实例ID。 |
SqlId | String | 是 | 651b56fe9418d48edb8fdf0980ec**** |
SQL ID。 |
Start | Long | 是 | 1660097421000 |
查询开始时间,格式为Unix时间戳,单位为毫秒。 说明 查询开始时间需要在数据库实例SQL洞察存储时长范围内,最大不能早于当前时间90天。
|
End | Long | 是 | 1660104621000 |
查询结束时间,格式为Unix时间戳,单位为毫秒。 说明 查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能小于1小时。
|
Role | String | 否 | polarx_cn |
PolarDB-X 2.0数据库实例节点信息。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Message | String | Successful |
请求返回消息。 说明 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。
|
RequestId | String | 0A74B755-98B7-59DB-8724-1321B394**** |
请求ID。 |
Data | Array of Item |
返回数据 |
|
Timestamp | Long | 1660100753556 |
执行SQL的时间,格式为Unix时间戳,单位为毫秒。 |
SqlId | String | 651b56fe9418d48edb8fdf0980ec**** |
SQL ID。 |
Sql | String | select * from testdb01 where **** |
SQL样本。 |
Database | String | dbtest |
数据库名。 |
Rt | double | 0.409789 |
执行耗时,单位为秒。 |
User | String | testuser |
执行SQL的用户名称。 |
LockWaitTime | double | 0.0137 |
锁等待时长,单位为秒。 |
LogicalRead | double | 165848 |
逻辑读。 |
PhysicalSyncRead | double | 0 |
物理同步读取。 |
PhysicalAsyncRead | double | 0 |
物理异步读取。 |
RowsExamined | Long | 2048576 |
总扫描行数。 说明 目前支持该字段的数据库:RDS MySQL、RDS PostgreSQL、PolarDB MySQL。
|
RowsReturned | Long | 14 |
返回行数。 |
OriginHost | String | 172.17.XX.XX |
访问来源。 |
ScanRows | Long | 0 |
扫描行数。 |
UpdateRows | Long | 0 |
更新行数。 |
SqlType | String | SELECT |
SQL语句的类型,取值包括:SELECT、INSERT、UPDATE、DELETE、LOGIN、LOGOUT、MERGE、ALTER、CREATEINDEX、DROPINDEX、CREATE、DROP、SET、DESC、REPLACE、CALL、BEGIN、DESCRIBE、ROLLBACK、FLUSH、USE、SHOW、START、COMMIT和RENAME。 |
Scnt | Long | 0 |
PolarDB-X 2.0计算节点(CN)的DN请求数。 |
Rows | Long | 0 |
PolarDB-X 2.0计算节点(CN)的更新/返回行数。 |
Frows | Long | 0 |
PolarDB-X 2.0计算节点(CN)的拉取行数。 |
Code | Long | 200 |
返回的状态码。 |
Success | Boolean | true |
请求是否执行成功:
|
示例
请求示例
http(s)://das.cn-shanghai.aliyuncs.com/?Action=GetFullRequestSampleByInstanceId
&UserId=196278346919****
&InstanceId=rm-2ze8g2am97624****
&SqlId=651b56fe9418d48edb8fdf0980ec****
&Start=1660097421000
&End=1660104621000
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<GetFullRequestSampleByInstanceIdResponse>
<Message>Successful</Message>
<RequestId>0A74B755-98B7-59DB-8724-1321B394****</RequestId>
<Data>
<Timestamp>1660100753556</Timestamp>
<SqlId>651b56fe9418d48edb8fdf0980ec****</SqlId>
<Sql>select * from testdb01 where ****</Sql>
<Database>dbtest</Database>
<Rt>0.409789</Rt>
<User>testuser</User>
<LockWaitTime>0.0137</LockWaitTime>
<LogicalRead>165848</LogicalRead>
<PhysicalSyncRead>0</PhysicalSyncRead>
<PhysicalAsyncRead>0</PhysicalAsyncRead>
<RowsExamined>2048576</RowsExamined>
<RowsReturned>14</RowsReturned>
<OriginHost>172.17.XX.XX</OriginHost>
<ScanRows>0</ScanRows>
<UpdateRows>0</UpdateRows>
<SqlType>SELECT</SqlType>
<Scnt>0</Scnt>
<Rows>0</Rows>
<Frows>0</Frows>
</Data>
<Code>200</Code>
<Success>true</Success>
</GetFullRequestSampleByInstanceIdResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Message" : "Successful",
"RequestId" : "0A74B755-98B7-59DB-8724-1321B394****",
"Data" : [ {
"Timestamp" : 1660100753556,
"SqlId" : "651b56fe9418d48edb8fdf0980ec****",
"Sql" : "select * from testdb01 where ****",
"Database" : "dbtest",
"Rt" : 0.409789,
"User" : "testuser",
"LockWaitTime" : 0.0137,
"LogicalRead" : 165848,
"PhysicalSyncRead" : 0,
"PhysicalAsyncRead" : 0,
"RowsExamined" : 2048576,
"RowsReturned" : 14,
"OriginHost" : "172.17.XX.XX",
"ScanRows" : 0,
"UpdateRows" : 0,
"SqlType" : "SELECT",
"Scnt" : 0,
"Rows" : 0,
"Frows" : 0
} ],
"Code" : 200,
"Success" : true
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParams | The request parameters are invalid. | 请求参数错误 |
访问错误中心查看更多错误码。