调用DescribeSQLLogReportList接口查看SQL日志运行报告列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeSQLLogReportList |
系统规定参数。取值:DescribeSQLLogReportList。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
实例ID。可调用DescribeDBInstances获取。 |
EndTime | String | 是 | 2021-03-18T16:00:00Z |
查询结束时间,格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 说明 必须大于查询开始时间
|
StartTime | String | 是 | 2021-03-13T16:00:00Z |
查询开始时间,格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
PageSize | Integer | 否 | 30 |
每页记录数。取值:
默认值:30 |
PageNumber | Integer | 否 | 1 |
页码。大于0,且不超过Integer类型的最大值。 默认值:1 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Items | Array of Item |
SQL日志运行报告列表。 |
|
Item | |||
LatencyTopNItems | Array of LatencyTopNItem |
延迟最高的SQL列表。 |
|
LatencyTopNItem | |||
AvgLatency | Long | 500 |
SQL平均执行时间。单位:ms |
SQLExecuteTimes | Long | 5 |
SQL执行次数。 |
SQLText | String | SELECT * FROM table_name; |
SQL语句。 说明 展示SQL语句的前128个字符,仅统计执行时间大于100ms的SQL。
|
QPSTopNItems | Array of QPSTopNItem |
执行次数最多的SQL列表。 |
|
QPSTopNItem | |||
SQLExecuteTimes | Long | 5 |
SQL执行次数。 |
SQLText | String | SELECT * FROM table_name; |
SQL语句。 说明 展示SQL语句的前128个字符,仅统计执行时间大于5ms的SQL。
|
ReportTime | String | 2019-03-27T16:00:00Z |
运行报告生成时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间) |
PageNumber | Integer | 1 |
页码。 |
PageRecordCount | Integer | 30 |
本页SQL日志运行报告个数。 |
RequestId | String | 08A3B71B-FE08-4B03-974F-CC7EA6DB1828 |
请求ID。 |
TotalRecordCount | Integer | 60 |
总记录数。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DescribeSQLLogReportList
&DBInstanceId=rm-uf6wjk5xxxxxxx
&EndTime=2021-03-18T16:00:00Z
&StartTime=2021-03-13T16:00:00Z
&<公共请求参数>
正常返回示例
XML
格式
<DescribeSQLLogReportListResponse>
<TotalRecordCount>60</TotalRecordCount>
<PageRecordCount>30</PageRecordCount>
<RequestId>08A3B71B-FE08-4B03-974F-CC7EA6DB1828 </RequestId>
<PageNumber>1</PageNumber>
<Items>
<Item>
<ReportTime>2019-03-27T16:00:00Z</ReportTime>
<LatencyTopNItems>
<LatencyTopNItem>
<AvgLatency>500</AvgLatency>
<SQLExecuteTimes>5</SQLExecuteTimes>
<SQLText>SELECT * FROM table_name;</SQLText>
</LatencyTopNItem>
</LatencyTopNItems>
<QPSTopNItems>
<QPSTopNItem>
<SQLExecuteTimes>5</SQLExecuteTimes>
<SQLText>SELECT * FROM table_name;</SQLText>
</QPSTopNItem>
</QPSTopNItems>
</Item>
</Items>
</DescribeSQLLogReportListResponse>
JSON
格式
{
"TotalRecordCount": "60",
"PageRecordCount": "30",
"RequestId": "08A3B71B-FE08-4B03-974F-CC7EA6DB1828\t",
"PageNumber": "1",
"Items": {
"Item": [{
"ReportTime": "2019-03-27T16:00:00Z",
"LatencyTopNItems": {
"LatencyTopNItem": [{
"AvgLatency": "500",
"SQLExecuteTimes": "5",
"SQLText": "SELECT * FROM table_name;"
}]
},
"QPSTopNItems": {
"QPSTopNItem": [{
"SQLExecuteTimes": "5",
"SQLText": "SELECT * FROM table_name;"
}]
}
}]
}
}
错误码
访问错误中心查看更多错误码。