查询列存审计日志。
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
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": "polardbx:QueryColumnarLog",
"AuthPrincipalType": "222",
"AuthPrincipalOwnerId": "111",
"AuthPrincipalDisplayName": "示例 RAM 用户",
"PolicyType": "PRIORITY",
"NoPermissionType": "ImplicitDeny",
"EncodedDiagnosticMessage": "AQEAAAAAaKPfwjY0MzMyODRGLUZCQkQtNTA1RS04MUUxLTc5NTkzODk2MUIzMg=="
},
"Records": [
{
"key": "null"
}
],
"AppliedOffset": 0,
"AppliedRowLimit": 1000,
"ReturnedRowCount": 100,
"HasMore": true,
"RecordsSizeBytes": 8192,
"QueryElapsedTimeMilliseconds": 125
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。