すべてのプロダクト
Search
ドキュメントセンター

PolarDB:QueryColumnarLogSSE

最終更新日:Sep 10, 2026

ストリームを使用して列のストアの監査ログを照会します。

操作説明


今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

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 タイプ。有効な値:

  • SubUser: RAM ユーザー。

  • AssumedRoleUser: RAM ロール。

  • Federated: シングルサインオン (SSO) フェデレーション 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
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。