---
title: "GV$OB_SQL_AUDIT - OceanBase 数据库 V4.1.0 | OceanBase 文档中心"
description: GV$OB_SQL_AUDIT GV$OB_SQL_AUDIT 是全局 SQL 审计表，可以用来查看每次请求客户端来源、执行服务器信息、执行状态信息、等待事件以及执行各阶段耗时等。 SQL Audit 相关设置 设置 SQL Audit 的开关。 obclient> ALTER SYSTEM SET enable_s…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.1.0

# GV$OB_SQL_AUDIT

更新时间：2025-05-26 10:35:47

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.1.0/zh-CN/700.reference/300.performance-tuning-guide/500.sql-optimization/400.sql-optimization/300.monitor-sql-execution-performance/100.gv-ob-sql-audit.md)  

`GV$OB_SQL_AUDIT` 是全局 SQL 审计表，可以用来查看每次请求客户端来源、执行服务器信息、执行状态信息、等待事件以及执行各阶段耗时等。

## SQL Audit 相关设置

- 设置 SQL Audit 的开关。

  ```sql
  obclient> ALTER SYSTEM SET enable_sql_audit = true;
  /*开启 SQL Audit*/

  obclient> ALTER SYSTEM SET enable_sql_audit = false;
  /*关闭 SQL Audit*/

  ```
 - 设置 SQL Audit 所使用的内存占租户内存的百分比。默认内存百分比为 3，可设置范围为[0,80]。

  ```sql
  obclient> SET global ob_sql_audit_percentage = 3;
  Query OK, 0 rows affected

  ```

## SQL Audit 淘汰机制

租户的后台任务每隔 1s 会根据 OBServer 节点和 SQL Audit 的内存使用情况来决定是否触发淘汰 SQL。SQL Audit 内存上限根据 `ob_sql_audit_percentage` 分配可用的最大内存。

当 SQL Audit 的实际内存使用达到指定阈值时，满足触发淘汰的条件，开启淘汰；当 SQL Audit 的实际内存使用降到指定阈值时，满足停止淘汰的条件，停止淘汰。SQL Audit 淘汰机制如下表所示。

| **触发机制** | **SQL Audit 内存范围** | **触发淘汰的条件** | **停止淘汰的条件** |
| --- | --- | --- | --- |
| 内存使用 | [0,64M] | 内存上限 *50% | 0 M |
| 内存使用 | [64M,100M] | 内存上限-20M | 内存上限-40 M |
| 内存使用 | [100M,5G] | 内存上限 *80% | 内存上限 *60% |
| 内存使用 | [5G,+∞） | 内存上限-1G | 内存上限-2 G |
| 记录数 | 无 | 900 万 | 800万 |

## GV$OB_SQL_AUDIT 字段说明

| **字段名称** | **类型（MySQL 模式）** | **类型（Oracle 模式）** | **描述** |
| --- | --- | --- | --- |
| SVR_IP | varchar(46) | varchar(46) | IP 地址 |
| SVR_PORT | bigint(20) | number(38) | 端口号 |
| REQUEST_ID | bigint(20) | number(38) | 请求的 ID 号 |
| SQL_EXEC_ID | bigint(20) | number(38) | 如果 SQL 计划正在被执行，则显示对应的 SQL ID |
| TRACE_ID | varchar(128) | varchar(128) | 这条语句的 Trace ID |
| SID | bigint(20) unsigned | number(38) | Session ID |
| CLIENT_IP | varchar(46) | varchar(46) | 发送请求的 Client IP |
| CLIENT_PORT | bigint(20) | number(38) | 发送请求的 Client Port |
| TENANT_ID | bigint(20) | number(38) | 发送请求的租户 ID |
| TENANT_NAME | varchar(64) | varchar(46) | 发送请求的租户名称 |
| EFFECTIVE_TENANT_ID | bigint(20) | number(38) | 租户 ID |
| USER_ID | bigint(20) | number(38) | 发送请求的用户 ID |
| USER_NAME | varchar(64) | varchar(46) | 发送请求的用户名称 |
| USER_GROUP | bigint(20) | number(38) | 用户所属资源组的 ID |
| USER_CLIENT_IP | varchar(32) | varchar(32) | 发送请求的客户端的 IP |
| DB_ID | bigint(20) unsigned | number(38) | 数据库 ID |
| DB_NAME | varchar(128) | varchar(128) | 数据库名称 |
| SQL_ID | varchar(32) | varchar(32) | 这条 SQL 的 ID |
| QUERY_SQL | longtext | CLOB | 实际的 SQL 语句 |
| PLAN_ID | bigint(20) | number(38) | 执行计划 ID |
| AFFECTED_ROWS | bigint(20) | number(38) | 影响行数 |
| RETURN_ROWS | bigint(20) | number(38) | 返回行数 |
| PARTITION_CNT | bigint(20) | number(38) | 该请求涉及的分区数 |
| RET_CODE | bigint(20) | number(38) | 执行结果返回码 |
| QC_ID | bigint(20) unsigned | number(38) | 并行查询中的 qc_id |
| DFO_ID | bigint(20) | number(38) | 并行查询中的 dfo_id |
| SQC_ID | bigint(20) | number(38) | 并行查询中的 sqc_id |
| WORKER_ID | bigint(20) | number(38) | 线程 ID |
| EVENT | varchar(64) | varchar(64) | 最长等待事件名称 |
| P1TEXT | varchar(64) | varchar(64) | 等待事件参数 1 |
| P1 | bigint(20) unsigned | number(38) | 等待事件参数 1 的值 |
| P2TEXT | varchar(64) | varchar(64) | 等待事件参数 2 |
| P2 | bigint(20) unsigned | number(38) | 等待事件参数 2 的值 |
| P3TEXT | varchar(64) | varchar(64) | 等待事件参数 3 |
| P3 | bigint(20) unsigned | number(38) | 等待事件参数 3 的值 |
| LEVEL | bigint(20) | number(38) | 等待事件的 Level 级别 |
| WAIT_CLASS_ID | bigint(20) | number(38) | 等待事件所属的 Class ID |
| WAIT_CLASS# | bigint(20) | number(38) | 等待事件所属的 Class 的下标 |
| WAIT_CLASS | varchar(64) | varchar(64) | 等待事件所属的 Class 名称 |
| STATE | varchar(19) | varchar(19) | 等待事件的状态 |
| WAIT_TIME_MICRO | bigint(20) | number(38) | 该等待事件所等待的时间，单位：微秒 |
| TOTAL_WAIT_TIME_MICRO | bigint(20) | number(38) | 执行过程所有等待的总时间，单位：微秒 |
| TOTAL_WAITS | bigint(20) | number(38) | 执行过程总等待的次数 |
| RPC_COUNT | bigint(20) | number(38) | 发送 RPC 个数 |
| PLAN_TYPE | bigint(20) | number(38) | 执行计划类型：   - 1：本地执行计划（Local） - 2：远程执行计划（Remote） - 3：分布式执行计划（Distribute） |
| IS_INNER_SQL | tinyint(4) | number(38) | 是否为内部 SQL 请求 |
| IS_EXECUTOR_RPC | tinyint(4) | number(38) | 当前请求是否为 RPC 请求 |
| IS_HIT_PLAN | tinyint(4) | number(38) | 是否命中计划缓存 |
| REQUEST_TIME | bigint(20) | number(38) | 开始执行时间点，单位：微秒 |
| ELAPSED_TIME | bigint(20) | number(38) | 接收到请求到执行结束消耗总时间，单位：微秒 |
| NET_TIME | bigint(20) | number(38) | 发送 RPC 到接收到请求时间，单位：微秒 |
| NET_WAIT_TIME | bigint(20) | number(38) | 接收到请求到进入队列时间，单位：微秒 |
| QUEUE_TIME | bigint(20) | number(38) | 请求在队列等待时间，单位：微秒 |
| DECODE_TIME | bigint(20) | number(38) | 出队列后 Decode 时间，单位：微秒 |
| GET_PLAN_TIME | bigint(20) | number(38) | 开始执行到获得计划时间，单位：微秒 |
| EXECUTE_TIME | bigint(20) | number(38) | Plan 执行消耗时间，单位：微秒 |
| APPLICATION_WAIT_TIME | bigint(20) unsigned | number(38) | 所有 Application 类事件的总时间，单位：微秒 |
| CONCURRENCY_WAIT_TIME | bigint(20) unsigned | number(38) | 所有 Concurrency 类事件的总时间，单位：微秒 |
| USER_IO_WAIT_TIME | bigint(20) unsigned | number(38) | 所有 `user_io` 类事件的总时间，单位：微秒 |
| SCHEDULE_TIME | bigint(20) unsigned | number(38) | 所有 Schedule 类事件的时间，单位：微秒 |
| ROW_CACHE_HIT | bigint(20) | number(38) | 行缓存命中次数 |
| BLOOM_FILTER_CACHE_HIT | bigint(20) | number(38) | Bloom Filter 缓存命中次数 |
| BLOCK_CACHE_HIT | bigint(20) | number(38) | 块缓存命中次数 |
| DISK_READS | bigint(20) | number(38) | 物理读次数 |
| RETRY_CNT | bigint(20) | number(38) | 重试次数 |
| TABLE_SCAN | tinyint(4) | number(38) | 判断该请求是否含全表扫描 |
| CONSISTENCY_LEVEL | bigint(20) | number(38) | 一致性级别 |
| MEMSTORE_READ_ROW_COUNT | bigint(20) | number(38) | MemStore 中读的行数 |
| SSSTORE_READ_ROW_COUNT | bigint(20) | number(38) | `SSSTORE` 中读的行数 |
| DATA_BLOCK_READ_CNT | bigint(20) | NO | 访问的数据微块数量 |
| DATA_BLOCK_CACHE_HIT | bigint(20) | NO | 命中数据微块 Cache 数量 |
| INDEX_BLOCK_READ_CNT | bigint(20) | NO | 访问的中间层微块数量 |
| INDEX_BLOCK_CACHE_HIT | bigint(20) | NO | 命中中间层微块 Cache 数量 |
| BLOCKSCAN_BLOCK_CNT | bigint(20) | NO | 单边扫描的数据微块数量 |
| BLOCKSCAN_ROW_CNT | bigint(20) | NO | 单边扫描的数据行数 |
| PUSHDOWN_STORAGE_FILTER_ROW_CNT | bigint(20) | NO | 下压存储 Filter 过滤后行数 |
| REQUEST_MEMORY_USED | bigint(20) | number(38) | 该请求消耗的内存 |
| EXPECTED_WORKER_COUNT | bigint(20) | number(38) | 请求期望的工作线程数 |
| USED_WORKER_COUNT | bigint(20) | number(38) | 请求实际使用的工作线程数 |
| SCHED_INFO | varchar(16384) | varchar(16384) | 请求的调度信息 |
| FUSE_ROW_CACHE_HIT | bigint(20) | number(38) | 暂不支持该字段，字段默认为 `NULL` |
| PS_CLIENT_STMT_ID | bigint(20) | NO | 请求对应的 Prepare ID：   - `-1`：表示 SQL 语句没有使用 PS 协议 - 非 `-1`：表示 SQL 语句使用了 PS 协议，为 PS 协议在客户端对该语句返回的唯一标志 |
| PS_INNER_STMT_ID | bigint(20) | NO | 请求对应的 Prepare ID：   - `-1`：表示 SQL 语句没有使用 PS 协议 - 非 `-1`：表示 SQL 语句使用了 PS 协议，为 PS 协议在内部对该语句返回的唯一标志 |
| TX_ID | bigint(20) | NO | 请求对应的事务的 Hash 值 |
| SNAPSHOT_VERSION | bigint(20)unsigned | NO | 当前语句的快照读版本号 |
| REQUEST_TYPE | bigint(20) | number(38) | 请求对应的类型：   - 0：表示非法 - 1：表示是一个内部请求 - 2：表示是一个本地请求，例如 Local 计划 - 3：表示远程请求 - 4：表示分布式请求 - 5：表示 SQL 的 Prepare 请求 - 6：表示 SQL 得到 Execute Stmt 请求 - 7: 表示 SQL 得到 Fetch 请求 - 8: 表示 SQL 得到 `send_piece` 请求 - 9: 表示 SQL 得到 `get_piece` 请求 - 10: 表示 SQL 得到 `send_long_data` 请求 - 11: 表示当前 SQL 是 PL 调用的内部 SQL |
| IS_BATCHED_MULTI_STMT | tinyint(4) | number(38) | 是否进行 Batch Multi Stmt 的优化 |
| OB_TRACE_INFO | VARCHAR2(4096) | VARCHAR2(4096) | 用户设置的 Trace 信息 |
| PLAN_HASH | bigint(20) unsigned | number(38) | 执行计划的 Hash 值 |
| LOCK_FOR_READ_TIME | bigint(20) | #### 注意    该视图在 OceanBase 数据库 Oracle 模式中暂无字段 `LOCK_FOR_READ_TIME`。 | 读取数据时等待锁的耗时，单位：微秒 |
| PARAMS_VALUE | longtext | CLOB | 参数值 |

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线