DescribeSQLLogRecords操作を呼び出して、インスタンスのSQL Explorer (SQL監査) 機能によって生成されたログを照会できます。

この操作を呼び出す前に、インスタンスが次のデータベースエンジンのいずれかを実行していることを確認してください。

  • MySQL
  • SQL Server
  • PostgreSQL
説明
  • この操作は、アカウントごとに1分あたり最大2,000回呼び出すことができます。 Alibaba CloudアカウントとAlibaba Cloudアカウント内のRAMユーザーの両方を使用して開始された通話がカウントされます。
  • この操作は、ApsaraDB RDS for MySQLインスタンスのSQL Explorer Trial Editionによって生成されたログのクエリには使用できません。

デバッグ

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

リクエストパラメーター

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

実行する操作です。 値をDescribeSQLLogRecordsに設定します。

ClientToken String 任意 ETnLKlblzczshOTUbOCzxxxxxxx

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、生成されたトークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxx

インスタンスの ID です。

SQLId Long いいえ 25623548

SQL文の一意のID。

QueryKeywords String 任意 table_name

クエリに使用されるキーワード。

  • 一度に最大10個のキーワードを入力できます。 複数のキーワードを入力する場合は、キーワードをスペースで区切ります。
  • 指定した SQL 文のフィールド名がバッククォート (`) で囲まれていて、そのフィールド名をキーワードとして使用したい場合は、バッククォート (`) をフィールド名の一部として入力する必要があります。例えば、フィールド名が `id`である場合、`id`ではなく idと入力しなければなりません。.
StartTime String 必須 2011-06-01T15:00:00Z

クエリする期間の開始時刻です。 直近の30日以内に生成されたログを照会できます。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

データベース String 任意 データベース

データベースの名前。 入力できるデータベース名は1つだけです。このパラメータを指定した場合、この操作は指定されたデータベースに対して生成されたログのみを返します。 このパラメーターを指定しない場合、この操作はインスタンス上のすべてのデータベースに対して生成されたログを返します。

ユーザー String 任意 ユーザー

アカウントのユーザー名。 入力できるユーザー名は1つだけです。 このパラメーターを指定すると、指定したアカウントに対して生成されたログのみが返されます。 このパラメーターを指定しない場合、この操作はインスタンス上のすべてのアカウントに対して生成されたログを返します。

フォーム String 任意 Stream

SQL監査ログファイルを生成するか、SQL監査ログエントリを返すかを指定します。 有効な値:

  • File: このパラメーターをFileに設定すると、この操作によってSQL監査ログファイルが生成され、共通のレスポンスパラメーターのみが返されます。 この操作を呼び出した後、DescribeSQLLogFiles操作を呼び出して、SQL監査ログファイルのダウンロードURLを取得する必要があります。
  • Stream: このパラメーターをStreamに設定すると、この操作はSQL監査ログエントリを返します。 デフォルト値です。
説明 インスタンスがMySQLを実行し、ローカルSSDを使用している場合、またはRDSインスタンスがSQL Serverを実行している場合は、このパラメーターを Fileに設定できます。
EndTime String 必須 2011-06-11T15:00:00Z

クエリする期間の終了時刻を設定します。 終了時刻は開始時刻よりも後の時刻にする必要があります。 開始時間と終了時間の間の期間は30日未満でなければなりません。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

PageSize Integer いいえ 30

各ページで返されるエントリ数。 有効な値: 30100。 デフォルト値: 30

PageNumber Integer いいえ 1

返されるページ数。 有効値:0 以外の正の整数。

既定値:1

レスポンスパラメーター

項目 データ型 例: 説明
RequestId String 08A3B71B-FE08-4B03-974F-CC7EA6DB1828

リクエストの ID です。

PageNumber Integer 1

返されたページ数。

PageRecordCount Integer 30

現在のページのSQL監査ログエントリの数。

TotalRecordCount Long 100

返されたエントリの総数。

項目 SQLRecordの配列

各SQL監査ログエントリの詳細で構成される配列。

SQLRecord
HostAddress String 192.168.0.121

インスタンスに接続されているクライアントのIPアドレス。

SQLText String update test.zxb set id=0 limit 1

クエリで実行される SQL 文。

ReturnRowCounts Long 30

返されるSQL監査ログエントリの数。

DBName String testDB

データベースの名前。

ExecuteTime String 2011-06-11T15:00:23Z

SQL文が実行された時刻。 時間は、yyyy-MM-dd T HH:mm:ss Z形式に従います。 時刻は UTC で表示されます。

スレッドID String 1025865428

スレッドの ID。

TotalExecutionTimes Long 600

SQL文の実行期間。 単位:マイクロ秒。

AccountName String accounttest

SQL監査ログのエントリに記録されるアカウントのユーザー名です。

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeSQLLogRecords
&DBInstanceId=rm-uf6wjk5xxxxxx
&StartTime=2011-06-01T15:00:00Z
&EndTime=2011-06-11T15:00:00Z
&<共通リクエストパラメーター>

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

XML 形式

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

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeSQLLogRecordsResponse>
<PageNumber>1</PageNumber>
<TotalRecordCounts>1</TotalRecordCounts>
<ItemsCounts>1</ItemsCounts>
<SQLItems>
<SQLItem>
<DBName> テスト </DBName>
<AccountName>accounttest</AccountName>
<ホストアドレス> 192.168.0.121</ホストアドレス>
<SQLText>update test.zxb set id=0 limit 1</SQLText>
<TotalExecutionTimes>12</TotalExecutionTimes>
<ReturnRowCounts>34</ReturnRowCounts>
<ExecuteTime>2011-06-11T15:00:23Z</ExecuteTime>
</SQLItem>
</SQLItems>
<RequestId>08A3B71B-FE08-4B03-974F-CC7EA6DB1828</RequestId>
</DescribeSQLLogRecordsResponse>

JSON 形式

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

{
  "PageNumber" : 1,
  "TotalRecordCounts" : 1、
  "ItemsCounts" : 1,
  "SQLItems" : {
    "SQLItem" : [ {
      "DBName" : "test",
      "AccountName" : "accounttest" 、
      "HostAddress" : "192.168.0.121" 、
      "SQLText" : "update test.zxb set id=0 limit 1" 、
      "TotalExecutionTimes" : 12、
      "ReturnRowCounts" : 34、
      "ExecuteTime" : "2011-06-11T15:00:23Z"
    } ]
  },
  "RequestId" : "08A3B71B-FE08-4B03-974F-CC7EA6DB1828"
}

エラーコード

エラーコードの一覧については、「サービスエラーコード」をご参照ください。