DescribeSQLLogRecords操作を呼び出して、インスタンスのSQL Explorer (SQL監査) 機能によって生成されたログを照会できます。
この操作を呼び出す前に、インスタンスが次のデータベースエンジンのいずれかを実行していることを確認してください。
- MySQL
- SQL Server
- PostgreSQL
- この操作は、アカウントごとに1分あたり最大2,000回呼び出すことができます。 Alibaba CloudアカウントとAlibaba Cloudアカウント内のRAMユーザーの両方を使用して開始された通話がカウントされます。
- この操作は、ApsaraDB RDS for MySQLインスタンスのSQL Explorer Trial Editionによって生成されたログのクエリには使用できません。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | DescribeSQLLogRecords | 実行する操作です。 値をDescribeSQLLogRecordsに設定します。 |
ClientToken | String | 任意 | ETnLKlblzczshOTUbOCzxxxxxxx | リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、生成されたトークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。 |
DBInstanceId | String | 必須 | rm-uf6wjk5xxxxxxx | インスタンスの ID です。 |
SQLId | Long | いいえ | 25623548 | SQL文の一意のID。 |
QueryKeywords | String | 任意 | table_name | クエリに使用されるキーワード。
|
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監査ログエントリを返すかを指定します。 有効な値:
説明 インスタンスが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 | 各ページで返されるエントリ数。 有効な値: 30〜100。 デフォルト値: 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"
}
エラーコード
エラーコードの一覧については、「サービスエラーコード」をご参照ください。