全部產品
Search
文件中心

:查詢SQL日誌運行報告

更新時間:Feb 28, 2025

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

錯誤碼

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