调用DescribeSQLLogReports接口查询实例的SQL日志运行报告。

该接口已下线,后续请使用DescribeSQLLogReportList

查询实例的SQL日志运行报告。 注:一般作整点查询,如查询2-3点的运行报告。

调试

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

请求参数

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

系统规定参数。取值:DescribeSQLLogReports

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。可调用DescribeDBInstances获取。

StartTime String 2021-03-13T16:00:00Z

查询开始时间,格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

EndTime String 2021-03-18T16:00:00Z

查询结束时间,格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明 必须大于查询开始时间
PageSize Integer 30

每页记录数。取值:

  • 30
  • 50
  • 100

默认值:30

PageNumber Integer 1

页码。大于0,且不超过Integer类型的最大值。

默认值:1

返回数据

名称 类型 示例值 描述
RequestId String 08A3B71B-FE08-4B03-974F-CC7EA6DB1828

请求ID。

PageNumber Integer 1

页码。

PageRecordCount Integer 30

本页SQL日志运行报告个数。

TotalRecordCount Integer 60

总记录数。

Items Array of Item

SQL日志运行报告列表。

Item
ReportTime String 2019-03-27T16:00:00Z

运行报告生成时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)

LatencyTopNItems Array of LatencyTopNItem

延迟最高的SQL列表。

LatencyTopNItem
SQLText String SELECT * FROM table_name;

SQL语句。

说明 展示SQL语句的前128个字符,仅统计执行时间大于100ms的SQL。
SQLExecuteTimes Long 5

SQL执行次数。

AvgLatency Long 500

SQL平均执行时间。单位:ms

QPSTopNItems Array of QPSTopNItem

执行次数最多的SQL列表。

QPSTopNItem
SQLExecuteTimes Long 5

SQL执行次数。

SQLText String SELECT * FROM table_name;

SQL语句。

说明 展示SQL语句的前128个字符,仅统计执行时间大于5ms的SQL。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeSQLLogReports
&DBInstanceId=rm-uf6wjk5xxxxxxx
&EndTime=2021-03-18T16:00:00Z
&StartTime=2021-03-13T16:00:00Z
&<公共请求参数>

正常返回示例

XML格式

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

<DescribeSQLLogReportsResponse>
    <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>
</DescribeSQLLogReportsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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;"
        } ]
      }
    } ]
  }
}

错误码

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