tencent cloud

APIs

文档APIsTencentDB for DBbrainData Types

数据结构

下载
聚焦模式
字号
最后更新时间： 2026-10-15 15:40:18

AuditDBLogItem

DB 层审计日志单条明细。字段由 DruidCommonUtil#changeLogsTdsqlDB 和 BusinessCodeUtils 固定输出。LogType=All 时额外追加 FlowTime。

被如下接口引用：DescribeDBAuditLogs。

名称 类型 描述
Timestamp String

SQL 执行时间点（格式化字符串，yyyy-MM-dd HH:mm:ss）。
ClusterId String

集群 ID。
AffectRows Integer

影响行数。
CheckRows Integer

扫描行数。
CpuTime Integer

CPU 耗时（微秒）。
SetHost String

后端 Set Host（源字段 dbHost）。
DBName String

SQL 执行所在的数据库名。
ErrCode String

SQL 执行返回的错误码，0 表示成功。
ExecTime Integer

SQL 执行耗时（微秒）。
Host String

客户端来源 IP。
SetName String

Set 名称（源字段 instanceId）。
IoWaitTime Integer

IO 等待时间（微秒）。
LockWaitTime Integer

锁等待时间（微秒）。
SqlStartTimeNs Integer

SQL 开始时间（纳秒级时间戳）。
QueryId String

查询 ID（用于关联查询）。
QueryNo Integer

查询序号（同一事务内 SQL 的序列号）。
SentRows Integer

返回行数（扫描结果集行数）。
Sql String

执行的 SQL 语句原文。
SqlTemplateId String

SQL 模板 ID。
SqlType String

SQL 类型（如 Select、Insert、Update、Delete 等）。
Tables String

涉及的表。
ThreadId String

线程 ID。
SqlStartTime Integer

SQL 开始时间（毫秒级时间戳）。
TrxLivingTime Integer

事务存活时间（微秒）。
User String

执行 SQL 的数据库用户名。
TrxId String

事务 ID。
InternalXId String

内部 XID。
BusinessCode String

业务码（由业务侧 SQL 注释中 i/o/p 等 KV 提取）。
FlowTime Integer

网关流转耗时（毫秒），仅 LogType=All 时由 Gateway 日志关联后返回；LogType=DB 时该字段不下发。

AuditLogQueryFilter

审计日志查询过滤条件集合。所有字段均可选。注意：MultiSql 、 ExcludeMultiSql 以 JSON 字符串承载二维数组（云 API 平台不支持二维数组），示例：[[a,b]] 表示 (a OR b)。

被如下接口引用：DescribeDBAuditLogs。

名称 类型 必选 描述
SqlType Array of String 否

SQL 类型列表，取值如 SELECT、INSERT、UPDATE、DELETE 等。
ExecTime Array of Integer 否

执行耗时范围（毫秒），长度为 2 的数组：[最小值, 最大值]。
IoWaitTime Array of Integer 否

IO 等待耗时范围（毫秒），长度为 2 的数组。
CpuTime Array of Integer 否

CPU 耗时范围（毫秒），长度为 2 的数组。
LockWaitTime Array of Integer 否

锁等待耗时范围（毫秒），长度为 2 的数组。
ErrCode String 否

SQL 执行错误码，例如 0 表示成功。
ErrInfo String 否

错误信息。
DBName Array of String 否

数据库名列表。
User Array of String 否

用户名列表。
Host Array of String 否

来源 IP 列表。
ThreadId Array of String 否

线程 ID 列表。
ProxyHostList Array of String 否

代理节点 Host 列表。
SetHostList Array of String 否

后端 Set Host 列表。
SetIdList Array of String 否

后端 Set ID 列表。
MultiSql String 否

多 SQL 关键词条件，JSON 字符串，内部为二维数组：第一级为 AND，第二级为 OR。注意云 API 平台不支持二维数组，此处用字符串承载，服务端自动解析。
ExcludeMultiSql String 否

排除的多 SQL 关键词条件，JSON 字符串，结构同 MultiSql。
SqlTemplateId String 否

SQL 模板 ID。
SqlStartTime String 否

SQL 开始时间，示例：2026-10-10 11:05:06.002211

参数格式：YYYY-MM-DD hh:mm:ss.SSSSSS
QueryId String 否

查询 ID，关联查询时使用（LogType=All 时必填）。

AuditProxyLogItem

Proxy 层审计日志单条明细。字段由 DruidCommonUtil#changeLogsTdsqlProxy 和 BusinessCodeUtils 固定输出。

被如下接口引用：DescribeDBAuditLogs。

名称 类型 描述
Timestamp String

SQL 执行时间点（格式化字符串，yyyy-MM-dd HH:mm:ss）。
ClusterId String

集群 ID（dcdb/mariadb 集群标识，与 InstanceId 相同）。
AffectRows Integer

影响行数。
Autocommit String

是否自动提交。1 表示开启，0 表示关闭。
ComType String

MySQL 网络协议命令类型（如 COM_QUERY、COM_CONNECT 等）。
ConnTc Integer

新建连接耗时。
DBHost String

后端 DB 实例地址（多个用英文逗号分隔）。
DBName String

SQL 执行所在的数据库名。
ErrCode String

SQL 执行返回的错误码，0 表示成功。
ErrInfo String

错误信息。
ExecTime Integer

SQL 执行耗时（微秒）。
HoldConns String

请求结束后仍占用的连接数（非事务请求通常为 0）。
Host String

客户端来源 IP。
Mc String

是否开启全局一致性读（0 否、1 是）。
SqlStartTimeUs Integer

SQL 开始时间（微秒精度中的微秒部分）。
NewConnNum Integer

本次请求新建的连接数。
ProxyHost String

Proxy 代理节点地址。
ProxyId String

Proxy ID。
QueryId String

查询 ID（用于关联查询）。
SentRows Integer

返回行数（扫描结果集行数）。
Splited Integer

是否为 Proxy 改写后的查询：0 原始查询，1 改写后查询。
Sql String

执行的 SQL 语句原文。
SqlTemplate String

SQL 模板。
SqlTemplateId String

SQL 模板 ID。
SqlType String

SQL 类型（如 Select、Insert、Create、Login、Set 等）。
Tables String

涉及的表（多表以英文逗号分隔）。
ThreadId String

线程 ID。
SqlStartTime Integer

SQL 开始时间（毫秒级时间戳）。
User String

执行 SQL 的数据库用户名。
HostPort String

客户端连接的 HostPort。
ProxyThread String

Proxy 节点处理线程 ID。
DbHostNum String

后端 DB Host 数量。
BusinessCode String

业务码（由业务侧 SQL 注释中 i/o/p 等 KV 提取）。
BusinessTag String

业务标签（根据业务码后置补齐）。
上一篇: OpenAuditService下一篇: Error Codes

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈

搜索
    请输入关键词搜索文档