QueryColumnarLog - PolarDB

查詢欄存稽核日誌。

介面說明

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

polardbx:QueryColumnarLog

get

*全部資源。

*

無

請求文法

POST / HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	請求地域 ID，必須與目前 SQLQuery 服務部署地域一致。	cn-hangzhou
DBInstanceName	string	是	要查詢欄存稽核日誌的 PolarDB-X 執行個體 ID。	pxc-********
SQL	string	是	要執行的唯讀查詢語句。僅支援單條 MySQL SELECT；查詢資料表必須使用 polardbx_sls.<表名> 全限定形式，並且僅限 polardbx_sls.polardbx_log（核心日誌）、polardbx_sls.slow_detail_log（慢速日誌）、polardbx_sls.slow_trans_log（慢速交易日誌）和 polardbx_sls.sql_audit_log（稽核日誌）。不支援多語句、寫入操作、鎖定、使用者變數、動態預留位置或保留 Hint。	SELECT * FROM polardbx_sls.sql_audit_log LIMIT 100
MaxResultRows	integer	否	本次請求最多傳回的結果列數。取值範圍為 1～1000；未傳送時預設傳回不超過 100 列。最終列數還受 SQL 頂層 LIMIT 和目前服務策略約束。	1000

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。同一請求從接入、驗證、路由到查詢完成均使用該 ID，便於全鏈路排查。	9B2F3840-****-475C-B269-2D5C3A31797C
QueryId	string	服務為本次 JDBC 查詢產生的唯一識別碼。	{\"NodeId\":\"n_7844571364614995969\"}
AccessDeniedDetail	object	存取被拒絕的詳細原因。
AuthAction	string	驗證動作。	polardbx:QueryColumnarLog
AuthPrincipalType	string	驗證主體類型。	222
AuthPrincipalOwnerId	string	驗證主體 OwnerId。	111
AuthPrincipalDisplayName	string	驗證主體名稱。	範例 RAM 用戶
PolicyType	string	策略類型。	PRIORITY
NoPermissionType	string	無權限類型。	ImplicitDeny
EncodedDiagnosticMessage	string	診斷資訊。	AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg==
Records	array<object>	查詢結果清單。每列是欄名到文字值的 JSON 索引鍵值物件；所有純量均以字串傳回，SQL NULL 固定編碼為字串 null，空字串保持為空字串。
	object	下載記錄清單。
	string	查詢結果中的單個欄位值。所有純量均以字串傳回；SQL NULL 固定編碼為字串 null，空字串保持為空字串。	null
AppliedOffset	integer	服務實際套用的頂層 SQL LIMIT 偏移量；SQL 未指定偏移量時為 0。	0
AppliedRowLimit	integer	服務綜合 SQL 頂層 LIMIT、MaxResultRows、同步介面預設值和目前服務策略後實際套用的最大傳回列數，不包含用於偵測 HasMore 的額外一列。	1000
ReturnedRowCount	integer	本次同步回應實際傳回的結果列數。	100
HasMore	boolean	表示服務或 API 列數邊界是否截斷了呼叫方提交的 SQL；SQL 自身較小的 LIMIT 完整執行時為 false，不代表底層資料表中沒有更多資料。	False
RecordsSizeBytes	integer	所有傳回列的 JSON 物件 UTF-8 位元組數之和，不包含陣列和固定回應欄位。同步完整 JSON 回應還受 16 MiB 上限約束。	8192
QueryElapsedTimeMilliseconds	integer	從 JDBC 語句開始執行到讀取完最後一條傳回列或偵測列的耗時，單位為毫秒。	125

樣本

正常返回樣本

JSON格式

{
  "RequestId": "9B2F3840-****-475C-B269-2D5C3A31797C",
  "QueryId": "{\\\"NodeId\\\":\\\"n_7844571364614995969\\\"}",
  "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
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。