ストリームを使用して列のストアの監査ログを照会します。
操作説明
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST / HTTP/1.1
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
リクエストのリージョン ID。値は SQLQuery サービスがデプロイされているリージョンと一致する必要があります。 |
cn-hangzhou |
| DBInstanceName |
string |
必須 |
列のストアの監査ログをクエリする PolarDB-X インスタンスの ID。 |
pxc-******** |
| SQL |
string |
必須 |
実行する読み取り専用の検索文。単一の MySQL SELECT 文のみがサポートされています。クエリテーブルは完全修飾フォーム polardbx_sls.<table_name> を使用する必要があり、許可されるテーブルは polardbx_sls.polardbx_log (カーネルログ)、polardbx_sls.slow_detail_log (スロークエリログ)、polardbx_sls.slow_trans_log (低速トランザクションログ)、および polardbx_sls.sql_audit_log (監査ログ) のみです。複数ステートメントのクエリ、書き込み操作、ロック、ユーザー変数、動的プレースホルダー、および予約ヒントはサポートされていません。 |
SELECT * FROM polardbx_sls.sql_audit_log LIMIT 100 |
| MaxResultRows |
integer |
任意 |
このリクエストで返す結果行の最大値。有効な値: 1~10000。このパラメーターが指定されていない場合、呼び出し元が送信した SQL ステートメントに追加の行制限は適用されません。結果は、サーバー側の SSE 上限である 10000 行および SQL ステートメント内の最上位の LIMIT 句の主題となります。 |
1000 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| Type |
string |
SSE イベントタイプ。RECORD はクエリ結果のバッチを伝達します。EOF はクエリが完了したことを示します。ERROR はクエリが例外で終了したことを示します。 |
RECORD |
| RequestId |
string |
リクエスト ID。アクセス、認証、ルーティング、クエリ実行、およびすべての SSE イベントを含むリクエストの全段階で同じ ID が使用され、エンドツーエンドのトラブルシューティングを容易にします。 |
C457B28E-9CAB-4B77-B5C6-5D71B7870B6E |
| QueryId |
string |
この JDBC クエリに対してサービスによって生成された一意の識別子。同じ SSE ストリーム内のすべてのイベントは同じ QueryId を共有します。 |
5d3d88ea-3df0-4c2d-a8bb-2ec423b86b56 |
| Sequence |
integer |
RECORD イベントのシーケンス番号。1 から始まりインクリメントされます。このフィールドはイベントの注文を示し、結果行のオフセットを表すものではありません。 |
1 |
| Code |
string |
安定したエラーコード。このフィールドは Type が ERROR の場合にのみ返されます。Message テキストに依存せず、このフィールドに基づいてエラーを処理してください。 |
InternalError |
| Message |
string |
エラーのまとめ。このフィールドは Type が ERROR の場合にのみ返されます。 |
Query execution failed |
| Retryable |
boolean |
現在の ERROR がリトライに適しているかどうかを示します。値が true の場合、エラーとともに返された提案に基づいてリクエストをリトライできます。値が false の場合、リクエストを変更するか、サービスチームに連絡先を求めてトラブルシューティングを行う必要があります。 |
true |
| Partial |
boolean |
ERROR が発生する前に少なくとも 1 つの RECORD イベントが送信されたかどうかを示します。値が true の場合、呼び出し元がすでに受信した結果は不完全であり、完全なクエリ結果として扱うべきではありません。 |
|
| AccessDeniedDetail |
object |
アクセス拒否の詳細。 |
|
| AuthAction |
string |
上記のとおり。 |
polardbx:QueryColumnarLogSSE |
| AuthPrincipalType |
string |
リクエストの認証に使用された ID タイプ。有効な値:
|
222 |
| AuthPrincipalOwnerId |
string |
認証プリンシパルのオーナー ID。 |
111 |
| AuthPrincipalDisplayName |
string |
認証プリンシパルの表示名。 |
サンプル RAM ユーザー |
| PolicyType |
string |
ポリシータイプ。 |
PRIORITY |
| NoPermissionType |
string |
権限拒否のタイプ。 |
ImplicitDeny |
| EncodedDiagnosticMessage |
string |
エンコードされた診断メッセージ。 |
AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg== |
| Records |
array<object> |
Type が RECORD の場合にのみ返されます。このイベントによって伝達されるクエリ結果のバッチ。各行は列名をテキスト値にマッピングする JSON キー値オブジェクトです。SQL NULL は文字列 null としてエンコードされます。 |
|
|
object |
データテーブルのフィールド。 |
||
|
string |
クエリ結果内の単一列の値。すべてのスカラー値は文字列として返されます。SQL NULL は文字列 null としてエンコードされます。空の文字列は空の文字列のままです。 |
null |
|
| AppliedOffset |
integer |
Type が EOF の場合にのみ返されます。サービスによって実際に適用された最上位の SQL LIMIT オフセット。SQL ステートメントでオフセットが指定されていない場合、値は 0 です。 |
0 |
| AppliedRowLimit |
integer |
Type が EOF の場合にのみ返されます。最上位の SQL LIMIT、MaxResultRows、および現在のサービスポリシーを組み合わせた後にサービスによって実際に適用された行数の最大値。この値には HasMore の検出に使用される追加の行は含まれません。 |
1000 |
| ReturnedRowCount |
integer |
Type が EOF の場合にのみ返されます。この SSE ストリームで実際に返された結果行の総数。 |
100 |
| HasMore |
boolean |
Type が EOF の場合にのみ返されます。サービスまたは API の行制限によって呼び出し元が送信した SQL ステートメントが切り捨てられたかどうかを示します。SQL ステートメントがより小さな LIMIT で完了した場合に値が false であっても、基になるテーブルにこれ以上データが存在しないことを示すものではありません。 |
False |
| RecordsSizeBytes |
integer |
Type が EOF の場合にのみ返されます。返されたすべての行 JSON オブジェクトの UTF-8 バイトサイズの合計。この値には配列、SSE フレーム、または固定応答フィールドは含まれません。 |
8192 |
| QueryElapsedTimeMilliseconds |
integer |
Type が EOF の場合にのみ返されます。JDBC 文の実行開始から最後の結果行またはプローブ行の読み取り完了までの経過時間 (ミリ秒単位)。 |
125 |
例
成功レスポンス
JSONJSON
{
"Type": "RECORD",
"RequestId": "C457B28E-9CAB-4B77-B5C6-5D71B7870B6E",
"QueryId": "5d3d88ea-3df0-4c2d-a8bb-2ec423b86b56",
"Sequence": 1,
"Code": "InternalError",
"Message": "Query execution failed",
"Retryable": true,
"Partial": false,
"AccessDeniedDetail": {
"AuthAction": "xxx",
"AuthPrincipalType": "222",
"AuthPrincipalOwnerId": "111",
"AuthPrincipalDisplayName": "xxx",
"PolicyType": "PRIORITY",
"NoPermissionType": "ImplicitDeny",
"EncodedDiagnosticMessage": "AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg=="
},
"Records": [
{
"key": "null"
}
],
"AppliedOffset": 0,
"AppliedRowLimit": 1000,
"ReturnedRowCount": 100,
"HasMore": true,
"RecordsSizeBytes": 8192,
"QueryElapsedTimeMilliseconds": 125
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。