调用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;"
        } ]
      }
    } ]
  }
}

错误码

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