文档中心

数据结构

最近更新时间：2023.11.16 14:51:27

首次发布时间：2022.11.18 17:51:54

本文汇总数据库工作台 DBW 的 API 接口中使用的数据结构定义详情。

DescribeAuditLogDetailRow

审计日志的详细信息。被以下接口引用：

DescribeAuditLogDetail

参数	类型	示例值	描述
LogLevel	String	Normal	日志等级，取值如下： `Normal`：表示正常日志。 `Incident`：表示冲突日志 `Warning`：表示警告日志。
User	String	root	执行者名称。
DB	String	information_schema	数据库名称。
SourceIP	String	127.0.0.1	IP 地址。
LogType	String	查询操作	日志类型。常见的日志类型取值如下：修改库修改表修改用户启动事务提交事务创建新表创建视图新建用户创建库创建索引创建导入执行表达式删除库删除索引删除视图删除表删除用户全表删除删除数据查询执行计划 Flush 操作替换数据插入数据调用存储过程索引建议终止会话 Load 数据锁表 Plan 准备预处理执行预处理解除预处理 PURGE 操作查询操作重命名表重命名用户删除用户权限回滚设置变量操作显示信息查询执行信息清空表解锁表更新操作全量更新选库
Table	String	tablename	表名。
OriSql	String	Select * from func;	原始 SQL 文本。说明当需要执行多个 SQL 语句时，可使用英文分号（;）进行分割。
SqlMethod	String	SELECT	SQL 操作。取值如下： `SELECT`：查询。 `INSERT`：插入。 `UPDATE`：更新。 `DELETE`：删除。 `ALTER`：修改。 `CREATE`：创建。 `DROP`：删除。 `RENAME`：重命名。 `TRUNCATE`：清除。 `LOGIN`：登录。 `LOGOUT`：退出。
AffectRow	Integer	0	影响行数。
ExecTime	Integer	0	执行开始时间，单位：秒。
Duration	Integer	0	执行持续时间，单位：微秒。

Result

SQL 命令执行结果的详细信息。被以下接口引用：

DataExecCommands

名称	类型	示例值	描述
CommandStr	string	Select * from func;	执行的语句内容。
State	String	Success	命令执行状态，取值如下： Success：表示命令执行成功。 Failed：表示命令执行失败。 Cancel：表示取消执行命令。
ReasonDetail	string	UnknownError	当命令执行失败时，返回的信息。
RunTime	int64	1665741434000	执行 SQL 语句的开始时间戳，单位为：毫秒（ms）。
ColumnNames	array of String	[ "name", "ret", "dl", "type" ]	执行查询脚本时，返回的结果集字段列表。
RowCount	long	1000	列表的行的总数。
Rows	Array of Cell	[ { "Cells": [ "87", "01", "权限管理", "/admin/auth", "1" ] } ]	列表的行的信息。

SearchParam

需要查询的审计日志的参数信息。被以下接口引用：

DescribeAuditLogDetail

参数	类型	是否必选	示例值	描述
DBs	Array of String	否	[ "information_schema" ]	数据库列表信息。
Users	Array of String	否	[ "rootgg" ]	数据库账号列表信息。
SourceIPs	Array of String	否	[ "192.168.0.33" ]	IP 列表。
LogLevels	Array of String	否	["Normal", "Incident", "Warning"]	日志等级，取值如下： `Normal`：表示正常日志。 `Incident`：表示冲突日志 `Warning`：表示警告日志。
LogType	Array of String	否	["创建表", "查询操作"]	日志类型。常见的日志类型取值如下：修改库修改表修改用户启动事务提交事务创建新表创建视图新建用户创建库创建索引创建导入执行表达式删除库删除索引删除视图删除表删除用户全表删除删除数据查询执行计划 Flush 操作替换数据插入数据调用存储过程索引建议终止会话 Load 数据锁表 Plan 准备预处理执行预处理解除预处理 PURGE 操作查询操作重命名表重命名用户删除用户权限回滚设置变量操作显示信息查询执行信息清空表解锁表更新操作全量更新选库
DuringUp	Integer	否	100	执行时间上限，单位：微秒。
DuringDown	Integer	否	10	执行时间下限，单位：微秒。
AffectRowUp	Integer	否	100	影响行数上限。
AffectRowDown	Integer	否	100	影响行数下限。
SqlMethods	Array of String	否	["SELECT", "INSERT"]	SQL 操作，取值如下： `SELECT`：查询。 `INSERT`：插入。 `UPDATE`：更新。 `DELETE`：删除。 `ALTER`：修改。 `CREATE`：创建。 `DROP`：删除。 `RENAME`：重命名。 `TRUNCATE`：清除。 `LOGIN`：登录。 `LOGOUT`：退出。

Slowlog

慢日志的详细信息。被以下接口引用：

DescribeSlowLogs

参数	类型	示例值	描述
ConnectionId	Integer	2145056	连接 ID。
DB	String	information_schema	数据库名称。
LockTime	Float	0	表示执行被查询对象时需要的锁等待时间，即查询对象可能在别的会话中被锁定，其他语言就需要等待锁释放才可以执行查询操作，这段时间就是锁等待时间。
QueryTime	Float	3.000151	表示查询语句的耗时。
Timestamp	Integer	1681097392	按照查询开始时间排序。
RowsExamined	Integer	1	表示查询时需要扫描的行数。
RowsSent	Integer	1	命中查询结果后返回数据的行数。
SQLTemplate	String	`select sleep(?);`	SQL 模板。
SQLText	String	`select sleep(3);\n/usr/sbin/mysqld, Version: 8.0.26 (MySQL Community Server (GPL)). started with:\nTcp port: 3306 Unix socket: /var/run/mysqld/mysqld.sock\nTime Id Command Argument`	SQL 文本即实际执行的查询语句。
SourceIP	String	192.168.0.33	IP 地址。
User	String	rootgg	执行者名称。

DescribeAuditLogDetailRow

Result

SearchParam

Slowlog