明细查询页面支持查看 SQL 明细列表、查看 SQL 审计详情、下载 SQL 记录列表等操作。
一、支持的数据库
仅腾讯云 TDSQL-C for MySQL、MariaDB、TDSQL MySQL、PostgreSQL 实例支持明细查询。
暂不支持 MySQL 实例明细查询,若需要查看 SQL 明细,请前往 MySQL 控制台,找到目标实例,进入日志中心 > 审计日志页面,查看完整的 SQL 明细。
二、前提条件
已为实例开启全链路分析功能。具体操作请参见 开启全链路分析。
三、查看 SQL 明细列表
1. 登录 DBbrain 控制台。
2. 在左侧导航栏,选择全链路分析 > 明细查询。
3. 在页面顶部选择数据库类型、实例 ID 或集群 ID。
4. 通过以下方式筛选 SQL。
·时间范围:选择时间范围,支持近1分钟、近15分钟、近1小时快捷时段和自定义近一天内的连续1小时时间段。
·关键字:可输入一个或多个关键字进行模糊匹配,选择 OR 或 AND。
·更多字段筛选:在页面上方单击更多,展开可筛选的字段,在对应字段输入或选择筛选条件,支持同时设置多个字段,精确筛选 SQL。
5. 查看 SQL 明细。
TDSQL-C for MySQLTDSQL MySQL&MariaDBPostgreSQL
四、查看 SQL 明细
1. 设置聚合参数,单击搜索。
关键字搜索除支持 OR|AND 控制逻辑查询关系外,还支持排除搜索。可在 SQL 列表右上方单击帮助查看排除搜索和关键字分词规则。
排除搜索:可在关键词前输入NOT+空格实现排除搜索。若 NOT 前有转义符号\\,则是匹配NOT关键词。
示例:
具体的参数说明如下表所示。
| 参数 | 说明 |
| 设置时间范围 | 根据你的需要,选择展示数据的时间范围,快捷选择近1分钟、近15分钟、近1小时,也可自定义时间段。 |
| 关键字 | 是 SQL 内容中包含的关键字信息过滤,多个回车分隔。关键字分词规则:对 SQL 通过分词符分词:@&?|#()='",;:<>[]{}/ \\`,也保留完整 SQL 关键词和数据库对象标识符SQL 中的注释字段不参与分词,不能关键词检索查询不区分大小写要查询有分词符的关键词或对象标识,需要对其通过单引号括起来支持模糊搜索,使用*作为通配符,例如 foo*。前端对包含通配符的关键词不会进行辅助分词多个可使用下拉菜单中的 OR|AND 控制逻辑查询关系,并支持 NOT 排除搜索。 |
| 精确时间 | 精确时间与时间范围字段的存在差异,时间范围字段控件选择定位 SQL 的时间会比较广,精确时间定位的 SQL 时间比较精确。如果你已知 Proxy 一条日志精确到时间戳的时间,那么可以直接粘贴这个时间进行链路查询与解析。支持 NOT 排除搜索。示例:2025-09-24 15:56:14.002826609 |
| 数据库 | 数据库名称,多个回车分隔。支持 NOT 排除搜索。 |
| 用户 | 用户名,多个回车分隔。支持 NOT 排除搜索。 |
| 来访 IP | 来源 IP 字段,多个回车分隔。支持 NOT 排除搜索。 |
| SQL 类型 | 下拉选择,也可以自行输入,目前将常用的类型做了匹配。可以选择一个或多个类型。 |
| 耗时 | 耗时字段,你可以根据需要,查找 SQL 处理时间大于、小于、区间时间内的所有 SQL。耗时字段包括执行时间 (µs)、CPU 消耗 (ns)、锁等待 (µs)、IO 等待时间 (ns)。 |
| 线程 ID | 可以查询一个或者多个,多个回车分隔。支持 NOT 排除搜索。 |
| 执行状态 | SQL 执行状态,包括成功、失败和所有。 |
| 错误码 | 输入错误码过滤。支持 NOT 排除搜索。 |
2. 查看 SQL 明细。
列表字段说明如下表所示。
| 列表字段 | 说明 |
| 开始时间 | SQL 语句开始执行的时间。 |
| SQL 类型 | 执行的 SQL 语句所属 SQL 类型。 |
| SQL | 执行的 SQL 语句。鼠标悬停至 SQL 语句,展示复制和查看按钮,可复制 SQL 语句,可查看完整的 SQL 语句。 |
| 数据库 | 执行 SQL 语句所在数据库。 |
| 用户 | 发起 SQL 操作的用户名。 |
| 来访 IP | 执行 SQL 语句的客户端 IP 地址。 |
| 线程 ID | 标识和区分不同线程而分配的唯一标识符。 |
| 错误码 | 若执行 SQL 语句时出现错误,将显示对应的错误码。错误码为0,表示无错误。 |
| 原生事务 ID | MySQL 的原生事务 ID。 |
| Binlog Xid | Binlog 的日志文件中的唯一事务标识符。 |
| 返回行数 | 执行 SQL 语句后,返回的行数。 |
| 修改行数 | 在 SQL 更新中修改的 SQL 行数。 |
| 扫描行数 | 在 SQL 查询中搜索的记录的行数。 |
| 执行时间 (µs) | SQL 语句执行时间。 |
| CPU 消耗 (ns) | 指 SQL 查询在 CPU 上执行的时间。 |
| 锁等待时间 (µs) | 一个事务需要等待另一个事务释放锁的时间。 |
| IO 等待时间 (ns) | 一个线程需要等待 IO 操作完成时所花费的时间。 |
| 事务存在时间 (µs) | 从事务开始到提交或回滚之间的总时长。 |
| 操作 | 查看审计详情和优化建议:单击详情,查看审计详情的具体说明及操作请参见 查看审计详情和优化建议。 |
在 SQL 模板列表右上方单击,自定义列表字段,单击确认。
五、查看审计详情
在 SQL 明细列表的操作列单击详情,查看当前 SQL 的审计详情和优化建议。
六、查看 SQL 明细
列表字段说明如下表所示。
| 列表字段 | 说明 |
| 开始时间 | SQL 语句开始执行的时间。 |
| SQL 类型 | 执行的 SQL 语句所属 SQL 类型。 |
| SQL | 执行的 SQL 语句。鼠标悬停至 SQL 语句,展示复制和查看按钮,可复制 SQL 语句,可查看完整的 SQL 语句。 |
| 标签值 | 在 SQL 语句中根据业务不同添加的标识,对 SQL 语句通过该标识(即标签值)进行分类分析。 |
| 数据库 | 执行 SQL 语句所在数据库。 |
| 后端 DB 个数 | 后端 DB 个数 = 分片数量 × 每个分片组的节点数。 |
| 用户 | 发起 SQL 操作的用户名。 |
| 来访 IP | 执行 SQL 语句的客户端 IP 地址。 |
| 影响行数 | SQL 操作中受到影响的记录行数。 |
| 总耗时 (µs) | SQL 语句执行时间。查找总耗时大于、小于、区间时间内的所有 SQL。 |
| 线程 ID | 标识和区分不同线程而分配的唯一标识符。 |
| Proxy 原生线程 ID | 每个客户端连接在 Proxy 层被分配一个独立且唯一的线程 ID。用于追踪和诊断连接与会话问题。 |
| 错误码 | 若执行 SQL 语句时出现错误,将显示对应的错误码。错误码为0,表示无错误。 |
| 错误信息 | 若执行 SQL 语句时出现错误,将显示对应的错误信息。 |
| Timestamp | 时间戳。 |
| 操作 | 查看审计详情:单击详情,查看审计详情的具体说明及操作请参见 查看审计详情。查看前后 SQL:单击前后 SQL,查看前后 SQL 的具体说明及操作请参见 查看前后 SQL。 |
在 SQL 模板列表右上方单击,自定义列表字段,单击确定。
七、查看审计详情
1. 在 SQL 列表中,在目标 SQL 对应的操作列单击详情。
2. 在审计详情页面查看审计项及审计信息。
单击前后 SQL,可查看该 SQL 语句的前后 SQL,具体请参见 查看前后 SQL。
八、查看前后 SQL
1. 在 SQL 列表中,在目标 SQL 对应的操作列单击前后 SQL。
2. 在前后 SQL 页面查看前后 SQL 语句。
单击详情,可查看该 SQL 的审计详情。
九、查看 SQL 明细
1. 设置聚合参数,单击搜索。
关键词搜索除支持 OR|AND 控制逻辑查询关系外,还支持排除搜索。可在 SQL 列表右上方单击帮助查看排除搜索和关键字分词规则。
排除搜索:可在关键词前输入NOT+空格实现排除搜索。若 NOT 前有转义符号\\,则是匹配NOT关键词。
示例:
具体的参数说明如下表所示。
| 参数 | 说明 |
| 设置时间范围 | 根据你的需要,选择展示数据的时间范围,快捷选择近1分钟、近15分钟、近1小时,自定义近30天内连续1小时时段。 |
| 关键字 | 是 SQL 内容中包含的关键字信息过滤,多个回车分隔。关键字分词规则:对 SQL 通过分词符分词:@&?|#()='",;:<>[]{}/ \\`,也保留完整 SQL 关键词和数据库对象标识符SQL 中的注释字段不参与分词,不能关键词检索查询不区分大小写要查询有分词符的关键词或对象标识,需要对其通过单引号括起来支持模糊搜索,使用*作为通配符,例如 foo*。前端对包含通配符的关键词不会进行辅助分词多个可使用下拉菜单中的 OR|AND 控制逻辑查询关系,并支持 NOT 排除搜索。 |
| 数据库 | 数据库名称,多个回车分隔。多个可使用下拉菜单中的 OR|AND 控制逻辑查询关系,并支持 NOT 排除搜索。 |
| 用户 | 用户名,多个回车分隔。多个可使用下拉菜单中的 OR|AND 控制逻辑查询关系,并支持 NOT 排除搜索。 |
| 来访 IP | 来源 IP 字段,多个回车分隔。多个可使用下拉菜单中的 OR|AND 控制逻辑查询关系,并支持 NOT 排除搜索。 |
| SQL 类型 | 下拉选择,也可以自行输入,目前将常用的类型做了匹配。可以选择一个或多个类型。 |
2. 查看 SQL 明细。
列表字段说明如下表所示。
| 列表字段 | 说明 |
| 开始时间 | SQL 语句开始执行的时间。 |
| 执行语句 | 执行的 SQL 语句。 鼠标悬停至 SQL 语句,展示复制和查看按钮,可复制 SQL 语句,可查看完整的 SQL 语句。 |
| 来访 IP | 执行 SQL 语句的客户端 IP 地址。 |
| 用户 | 发起 SQL 操作的用户名。 |
| SQL 类型 | 执行的 SQL 语句所属 SQL 类型。 |
| 对象类型 | 对象类型包括:表、视图、索引、函数、触发器、架构、序列。 |
| 对象名称 | 对象名称。 |
| 执行状态码 | 执行 SQL 命令时可能会返回不同的状态码,这些状态码可以提供关于执行结果的信息。以下是一些常见的执行状态码:00000: 表示 SQL 命令成功完成。01000: 表示 SQL 命令执行时遇到警告。02000: 表示 SQL 命令没有返回数据。03000: 表示 SQL 命令的完成状态未知。08000: 表示在连接过程中发生异常。09000: 表示触发器执行时发生异常。0A000: 表示使用了不支持的特性。 |
| 执行时间 (µs) | SQL 语句执行时间。 |
| Session ID | 进程 ID。 |
| 影响行数 | 执行 SQL 语句后影响的行数。 |
| 操作 | 查看审计详情:单击详情,查看审计详情的具体说明及操作请参见 查看审计详情。 |
在 SQL 模板列表右上方单击,自定义列表字段,单击确认。
十、查看审计详情
1. 在 SQL 列表中,在目标 SQL 对应的操作列单击详情。
2. 在审计详情页面查看审计项及审计信息。
十一、下载 SQL 记录列表
1. 在 SQL 列表右上方单击,在弹出的对话框中单击下载,确认生成下载任务。
2. 在列表上方单击,查看文件下载进度,当状态显示为已完成,在操作列单击复制链接,在新的页面下载文件。
注意:内网下载:请在 VPC 网络中进行访问,使用 wget 命令下载:wget -c '<备份文件下载地址>' -O <自定义名称.tar.gz> 。
若需要删除下载任务,请在操作列单击删除任务,单击确定。