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

錯誤碼

訪問錯誤中心查看更多錯誤碼。