DescribeSQLLogReports操作を呼び出して、ApsaraDB RDSインスタンスのSQLログレポートを照会できます。

この操作は非推奨です。 DescribeSQLLogReportList操作を呼び出して、ApsaraDB RDSインスタンスのSQLログレポートを照会することを推奨します。

特定の時間枠内 (たとえば、02:00:00から03:00:00まで) に生成されたSQLログレポートを照会できます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明
操作 String 必須 DescribeSQLLogReports

実行する操作です。 値をDescribeSQLLogReportsに設定します。
DBInstanceId String 必須 rm-uf6wjk5xxxxxxx

インスタンスの ID。 DescribeDBInstancesを呼び出して、インスタンスのIDを照会できます。

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

照会する時間範囲の終わり。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

説明 終了時刻は開始時刻よりも後の時刻にする必要があります。
StartTime String 必須 2021-03-13T16:00:00Z

クエリする時間範囲の先頭。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

PageSize Integer いいえ 30

各ページで返されるエントリ数。 有効な値：

  • 30
  • 50
  • 100

デフォルト値: 30
PageNumber Integer いいえ 1

返すページの番号。 有効値: 任意の非ゼロ正の整数。

デフォルト値: 1

レスポンスパラメーター

項目 データ型 例: 説明
項目 アイテムの配列

SQLログレポートで構成される配列。

項目
LatencyTopNItems LatencyTopNItemの配列

最も高いレイテンシで実行されるSQL文で構成される配列。

LatencyTopNItem
AvgLatency Long 500

SQL文の実行に必要な平均時間。 単位：ミリ秒。
SQLExecuteTimes Long 5

SQL文が実行された回数。

SQLText String SELECT * FROM table_name;

返されたSQL文。

説明 Only the first 128 characters of the SQL statement are returned. さらに、実行に100 ms以上かかるSQL文のみが返されます。
QPSTopNItems QPSTopNItemの配列

最も頻繁に実行されるSQL文で構成される配列。

QPSTopNItem
SQLExecuteTimes Long 5

SQL文が実行された回数。

SQLText String SELECT * FROM table_name;

返されたSQL文。

説明 SQL文の最初の128文字のみが返されます。 さらに、実行に5ミリ秒以上かかるSQL文のみが返されます。
レポートタイム String 2019-03-27T16:00:00Z

レポートが生成された時刻。ISO 8601規格に準じた時間 yyyy-MM-ddTHH:mm:ssZ のフォーマットで表示されます。時刻はUTCで表示されます。
PageNumber Integer 1

返されたページ数。

PageRecordCount Integer 30

現在のページのレポートの数。

RequestId String 08A3B71B-FE08-4B03-974F-CC7EA6DB1828

リクエストの ID です。

TotalRecordCount Integer 60

返されたレコードの総数。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeSQLLogReports
&DBInstanceId=rm-uf6wjk5xxxxxxx
&EndTime=2021-03-18T16:00:00Z
&StartTime=2021-03-13T16:00:00Z
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

<DescribeSQLLogReportsResponse>
      <TotalRecordCount>60</TotalRecordCount>
      <PageRecordCount>30</PageRecordCount>
      <RequestId>08A3B71B-FE08-4B03-974F-CC7EA6DB1828 </RequestId>
      <ページ番号> 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>
      </アイテム>
</DescribeSQLLogReportsResponse>

JSON 形式

{
    "TotalRecordCount": "60" 、
    "PageRecordCount": "30" 、
    "RequestId": "08A3B71B-FE08-4B03-974F-CC7EA6DB1828\t" 、
    &quot;ページ番号&quot;： &quot;1&quot;、
    "Items": {
        "アイテム": [{
            "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;"
                }]
            }
        }]
    }
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。