DescribeSparkAuditLogRecords查询Spark Interactive资源组的SQL审计日志-云原生数据仓库AnalyticDB-阿里云

查询Spark Interactive资源组的SQL审计日志。

接口说明

仅当 SQL 审计状态为开启时，才能查询到 SQL 审计日志，且只支持查询 30 天内的 SQL 审计日志。如果中途关闭了 SQL 审计，再次打开时，仅能查询到再次打开后的 SQL 审计日志。

注意本接口只能查询到，通过 Spark Interactive 型资源组执行的 SQL 审计日志。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
adb:DescribeSparkAuditLogRecords	list	*DBClusterLakeVersion `acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}`	无	无

请求参数

名称	类型	必填	描述	示例值
DBClusterId	string	是	集群 ID。说明您可以调用 DescribeDBClusters 接口可以查询集群 ID。	amv-bp1j7******78j8i
RegionId	string	是	地域 ID。说明您可以调用 DescribeRegions 接口查看 AnalyticDB MySQL 版支持的地域和可用区信息，包括地域 ID。	cn-shanghai
StartTime	string	是	查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC 时间）。说明建议查询开始时间设置为 30 天内的任意时间点。	2025-09-25T00:00Z
EndTime	string	是	查询结束时间，需要大于查询开始时间，且与查询开始时间间隔小于 1 天。格式：yyyy-MM-ddTHH:mmZ（UTC 时间）。	2025-09-25T01:00Z
User	string	否	SQL 执行用户名。	test_user
Order	string	否	根据指定字段对 SQL 语句进行排序，格式为 JSON，是一个有序 JSON 数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"TotalTime", "Type": "desc" }]`。其中： `Field`表示需要排序的字段名，支持如下字段： `ResourceGroupName`：资源组名称。 `Status`：SQL 执行状态。 `User`：SQL 执行用户名。 `ExecuteTime`：SQL 执行开始时间。 `TotalTime`：SQL 执行时长。 `ProcessId`：查询 ID。 `ClientIp`：访问源地址。 `StatementSource`：查询发起来源。 `Type`表示排序类型，支持如下取值（取值均不区分大小写）： `Desc`：降序。 `Asc`：升序。	[{\"Field\":\"ExecuteTime\",\"Type\":\"Desc\"}]
PageSize	integer	否	每页记录数。	30
PageNumber	integer	否	页码。	1
ProxyUser	string	否	废弃参数。	user
ResourceGroupName	string	否	资源组名称。说明您可以调用 DescribeDBResourceGroup 接口查看集群的资源组 ID。	test_job
Status	string	否	SQL 执行状态。枚举值： cancel：已取消。。 finish：执行成功。。 error：执行失败。。 timeout：执行超时。。	finish
StatementId	string	否	Statement ID。	fbd22066-1c03-xxxx-aa16-6ae28288****
TotalTime	string	否	SQL 执行时长，单位：毫秒（ms）。	3000
SQLText	string	否	SQL 语句中的关键词。	test_table_name
ProcessId	string	否	查询 ID。	999f2439-6b10-xxxx-a5d3-daf3b35c****
ClientIp	string	否	访问源地址。	192.168.XX.XX
StatementSource	string	否	查询发起来源。枚举值： SQL_EDITOR：SQL_EDITOR。 JDBC：JDBC。	SQL_EDITOR

返回参数

名称	类型	描述	示例值
	object
TotalCount	string	总记录数。	100
PageSize	string	每页记录数。	30
RequestId	string	请求 ID。	2D5867CF-423F-559F-BBB1-199A289E****
PageNumber	string	页码。	1
DBClusterId	string	集群 ID。	amv-bp1j7******78j8i
Items	array<object>	SQL 记录列表。
items	object	详情。
SQLText	string	SQL 语句详情。	SELECT * FROM adb_hdfs_import_source
TotalTime	long	SQL 执行时长，单位：毫秒（ms）。	40000
ExecuteTime	string	SQL 执行开始时间，UTC 时间，格式为：yyyy-MM-ddTHH:mm:ssZ。	2022-01-23T16:05:08Z
User	string	SQL 执行用户名。	test_user
StatementId	string	Statement ID。	fbd22066-1c03-xxxx-aa16-6ae28288****
Status	string	SQL 执行状态。枚举值： cancel：已取消。。 finish：执行成功。。 error：执行失败。。 timeout：执行超时。。	finish
ResourceGroupName	string	资源组名称。	test_job
AppId	string	Spark 应用 ID。	s202411061011hzc5d6476000****
InnerQueryId	string	Spark 应用内部 query 执行 ID。	1
IsDiagnosable	boolean	是否可诊断。	true
ClientIp	string	访问源地址。	192.168.XX.XX
ProcessId	string	查询 ID。	999f2439-6b10-xxxx-a5d3-daf3b35c****
StatementSource	string	查询发起来源。枚举值： SQL_EDITOR：SQL_EDITOR。 JDBC：JDBC。	SQL_EDITOR
ErrorMsg	string	SQL 执行错误信息。	notFoundIp
ErrorTrace	string	SQL 执行错误堆栈。	notFoundIpException
AccessDeniedDetail	string	访问被拒绝详细信息；只有 Ram 校验失败才会返回此字段	{ "PolicyType": "AccountLevelIdentityBasedPolicy", "AuthPrincipalOwnerId": "1***************7", "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==", "AuthPrincipalType": "SubUser", "AuthPrincipalDisplayName": "2*************9", "NoPermissionType": "ImplicitDeny", "AuthAction": "adb:DescribeExcessivePrimaryKeys" }

示例

正常返回示例

JSON格式

{
  "TotalCount": 100,
  "PageSize": 30,
  "RequestId": "2D5867CF-423F-559F-BBB1-199A289E****",
  "PageNumber": 1,
  "DBClusterId": "amv-bp1j7******78j8i",
  "Items": [
    {
      "SQLText": "SELECT * FROM adb_hdfs_import_source",
      "TotalTime": 40000,
      "ExecuteTime": "2022-01-23T16:05:08Z",
      "User": "test_user",
      "StatementId": "fbd22066-1c03-xxxx-aa16-6ae28288****",
      "Status": "finish",
      "ResourceGroupName": "test_job",
      "AppId": "s202411061011hzc5d6476000****",
      "InnerQueryId": 1,
      "IsDiagnosable": true,
      "ClientIp": "192.168.XX.XX",
      "ProcessId": "999f2439-6b10-xxxx-a5d3-daf3b35c****",
      "StatementSource": "SQL_EDITOR",
      "ErrorMsg": "notFoundIp",
      "ErrorTrace": "notFoundIpException"
    }
  ],
  "AccessDeniedDetail": {
    "PolicyType": "AccountLevelIdentityBasedPolicy",
    "AuthPrincipalOwnerId": "1*****************7",
    "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",
    "AuthPrincipalType": "SubUser",
    "AuthPrincipalDisplayName": "2***************9",
    "NoPermissionType": "ImplicitDeny",
    "AuthAction": "adb:DescribeExcessivePrimaryKeys"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。

访问错误中心查看更多错误码。