调用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
  • 50
  • 100

默认值: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;"
				}]
			}
		}]
	}
}

错误码

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