基于湖库一体架构，统一管理结构化、半结构化与非结构化等多模态数据，一个系统承载事务处理、实时分析与 AI 工作负载。
V$OB_SQL_AUDIT
更新时间：2026-08-17 10:57:42
编辑
分享
说明
该视图从 V4.0.0 版本开始引入。
功能描述
视图 V$OB_SQL_AUDIT 用于展示当前 OBServer 节点的每一次 SQL 请求的来源、执行状态等统计信息。该视图是按照租户拆分的，除了系统租户，其他租户不能跨租户查询。
字段说明
| 字段名称 | 类型 | 是否可以为 NULL | 描述 |
|---|---|---|---|
| SVR_IP | varchar(46) | NO | IP 地址 |
| SVR_PORT | bigint(20) | NO | 端口号 |
| REQUEST_ID | bigint(20) | NO | 请求的 ID 号 |
| SQL_EXEC_ID | bigint(20) | NO | 本次执行的 ID |
| TRACE_ID | varchar(128) | NO | 该语句的 trace_id |
| SID | bigint(20) unsigned | NO | 对于 V4.3.x 版本：
|
| CLIENT_IP | varchar(46) | NO |
|
| CLIENT_PORT | bigint(20) | NO | 发送请求的客户端端口号 |
| TENANT_ID | bigint(20) | NO | 发送请求的租户 ID |
| TENANT_NAME | varchar(64) | NO | 发送请求的租户名称 |
| EFFECTIVE_TENANT_ID | bigint(20) | NO | 租户 ID |
| USER_ID | bigint(20) | NO | 发送请求的用户 ID |
| USER_NAME | varchar(64) | NO | 发送请求的用户名称 |
| USER_GROUP | bigint(20) | NO | 用户所属资源组 ID |
| USER_CLIENT_IP | varchar(46) | NO | 发送请求的客户端的 IP |
| DB_ID | bigint(20) unsigned | NO | 数据库 ID |
| DB_NAME | varchar(128) | NO | 数据库名称 |
| SQL_ID | varchar(32) | NO | 该 SQL 的 ID
说明
|
| QUERY_SQL | longtext | NO | 实际的 SQL 语句 |
| PLAN_ID | bigint(20) | NO | 执行计划的 ID |
| AFFECTED_ROWS | bigint(20) | NO | 影响行数 |
| RETURN_ROWS | bigint(20) | NO | 返回行数 |
| PARTITION_CNT | bigint(20) | NO | 该请求涉及的分区数 |
| RET_CODE | bigint(20) | NO | 执行结果返回码：
有关错误码的详细介绍，请参见 错误码。 |
| QC_ID | bigint(20) unsigned | NO | 并行执行场景下，调度器 ID |
| DFO_ID | bigint(20) | NO | 并行执行场景下，当前执行的子计划 ID |
| SQC_ID | bigint(20) | NO | 并行执行场景下，本地协调器 ID |
| WORKER_ID | bigint(20) | NO | 并行执行场景下，工作线程 ID |
| EVENT | varchar(64) | NO | 最长等待事件名称 |
| P1TEXT | varchar(64) | NO | 等待事件参数 1 |
| P1 | bigint(20) unsigned | NO | 等待事件参数 1 的值 |
| P2TEXT | varchar(64) | NO | 等待事件参数 2 |
| P2 | bigint(20) unsigned | NO | 等待事件参数 2 的值 |
| P3TEXT | varchar(64) | NO | 等待事件参数 3 |
| P3 | bigint(20) unsigned | NO | 等待事件参数 3 的值 |
| LEVEL | bigint(20) | NO | 等待事件的级别 |
| WAIT_CLASS_ID | bigint(20) | NO | 等待事件所属的 Class ID |
| WAIT_CLASS# | bigint(20) | NO | 等待事件所属的 Class 的下标 |
| WAIT_CLASS | varchar(64) | NO | 等待事件所属的 Class 名称 |
| STATE | varchar(19) | NO | 等待事件的状态 |
| WAIT_TIME_MICRO | bigint(20) | NO | 该等待事件所等待的时间，单位：微秒 |
| TOTAL_WAIT_TIME_MICRO | bigint(20) | NO | 执行过程所有等待的总时间，单位：微秒 |
| TOTAL_WAITS | bigint(20) | NO | 执行过程总等待的次数 |
| RPC_COUNT | bigint(20) | NO | 发送的 RPC 个数 |
| PLAN_TYPE | bigint(20) | NO | 执行计划类型：
|
| IS_INNER_SQL | tinyint(4) | NO | 是否为内部 SQL 请求 |
| IS_EXECUTOR_RPC | tinyint(4) | NO | 当前请求是否为 RPC 请求 |
| IS_HIT_PLAN | tinyint(4) | NO | 是否命中 plan_cache |
| REQUEST_TIME | bigint(20) | NO | 开始执行时间点，单位：微秒 |
| ELAPSED_TIME | bigint(20) | NO | 接收到请求到执行结束所消耗的总时间，单位：微秒 |
| NET_TIME | bigint(20) | NO | 发送 RPC 到接收到请求的时间，单位：微秒 |
| NET_WAIT_TIME | bigint(20) | NO | 接收到请求到进入队列的时间，单位：微秒 |
| QUEUE_TIME | bigint(20) | NO | 请求在队列的等待时间，单位：微秒 |
| DECODE_TIME | bigint(20) | NO | 出队列后 Decode 的时间，单位：微秒 |
| GET_PLAN_TIME | bigint(20) | NO | 开始 Process 到获得计划的时间，单位：微秒 |
| EXECUTE_TIME | bigint(20) | NO | 计划执行所消耗的时间，单位：微秒 |
| APPLICATION_WAIT_TIME | bigint(20) unsigned | NO | 所有 Application 类事件的总时间，单位：微秒 |
| CONCURRENCY_WAIT_TIME | bigint(20) unsigned | NO | 所有 Concurrency 类事件的总时间，单位：微秒 |
| USER_IO_WAIT_TIME | bigint(20) unsigned | NO | 所有 user_io 类事件的总时间，单位：微秒 |
| SCHEDULE_TIME | bigint(20) unsigned | NO | 所有 Schedule 类事件的时间，单位：微秒 |
| ROW_CACHE_HIT | bigint(20) | NO | 行缓存命中次数 |
| BLOOM_FILTER_CACHE_HIT | bigint(20) | NO | Bloom Filter 缓存命中次数 |
| BLOCK_CACHE_HIT | bigint(20) | NO | 块缓存命中次数 |
| DISK_READS | bigint(20) | NO | 物理读次数 |
| RETRY_CNT | bigint(20) | NO | 重试次数 |
| TABLE_SCAN | tinyint(4) | NO | 判断该请求是否含全表扫描 |
| CONSISTENCY_LEVEL | bigint(20) | NO | 一致性级别，取值如下：
|
| MEMSTORE_READ_ROW_COUNT | bigint(20) | NO | 做 Filter 前从 MemStore 读取的行数 |
| SSSTORE_READ_ROW_COUNT | bigint(20) | NO | 下压/非下压路径下读取的 Major SSTable、Minor SSTable、Mini SSTable 行数 |
| 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 | 下压路径下打开的微块在 Range 范围内的总行数 |
| PUSHDOWN_STORAGE_FILTER_ROW_CNT | bigint(20) | NO | 下压/非下压 Filter 过滤的总行数 |
| REQUEST_MEMORY_USED | bigint(20) | NO | 该请求消耗的内存 |
| EXPECTED_WORKER_COUNT | bigint(20) | NO | 请求期望的工作线程数 |
| USED_WORKER_COUNT | bigint(20) | NO | 请求实际使用的工作线程数 |
| SCHED_INFO | varchar(16384) | NO | 请求的调度信息 |
| FUSE_ROW_CACHE_HIT | bigint(20) | NO | 暂不支持该字段，字段默认为 NULL |
| PS_CLIENT_STMT_ID | bigint(20) | NO | 请求对应的 Prepare ID：
|
| PS_INNER_STMT_ID | bigint(20) | NO | 请求对应的 Prepare ID：
|
| TX_ID | bigint(20) | NO | 请求对应的事务 ID |
| SNAPSHOT_VERSION | bigint(20) | NO | SQL语句使用的读快照版本 |
| REQUEST_TYPE | bigint(20) | NO | 请求对应的类型：
|
| IS_BATCHED_MULTI_STMT | tinyint(4) | NO | 是否进行 Batch Multi Stmt 的优化 |
| OB_TRACE_INFO | varchar(4096) | NO | 用户设置的 Trace 信息 |
| PLAN_HASH | bigint(20) unsigned | NO | 执行计划的 Hash 值 |
| LOCK_FOR_READ_TIME | bigint(20) | NO | 读取数据时等待锁的耗时，单位：微秒 |
| PARAMS_VALUE | longtext | NO | PS 绑定的参数值 |
| RULE_NAME | varchar(256) | NO | 规则名称
说明该字段从 V4.1.0 版本开始引入。 |
| PARTITION_HIT | tinyint(4) | NO |
说明该字段从 V4.1.0 版本开始引入。 |
| TX_INTERNAL_ROUTING | bigint(20) | NO | 表示 SQL 语句是否经过了内部路由：
说明该字段从 V4.1.0 版本开始引入。 |
| TX_STATE_VERSION | bigint(20) unsigned | NO | 表示 SQL 语句的事务状态版本
说明该字段从 V4.1.0 版本开始引入。 |
| FLT_TRACE_ID | varchar(1024) | NO | 表示该条记录全链路追踪的 trace_id，如果为空，则说明没有被全链路追踪监控。该字段是Uuid，不同于 Trace。其表示形式类似于：000600d6-a5de-038c-6c80-df07e4e79149
说明该字段从 V4.2.1 版本开始引入。 |
| PL_TRACE_ID | varchar(128) | NO | 当前 SQL 语句外层 PL 的 Trace ID (如果没有外层 PL 则该值 NULL)
说明
|
| PLSQL_EXEC_TIME | bigint(20) | NO | PL 执行的耗时（不包括 SQL 执行时间），单位为微秒
说明
|
| FORMAT_SQL_ID | varchar(32) | NO | 表示该条记录通过 Format SQL text 生成的 MD5 值。 |
| STMT_TYPE | varchar(128) | YES | DML 类型会按需返回：
|
| TOTAL_MEMSTORE_READ_ROW_COUNT | bigint(20) | NO | 整个工作过程中从 MemStore 读出的总行数（仅在展示 query_text 的线程中显示该变量）
说明
|
| TOTAL_SSSTORE_READ_ROW_COUNT | bigint(20) | NO | 整个工作过程中从 SSSTORE 读出的总行数（仅在展示 query_text 的线程中显示该变量）
说明
|
| PROXY_USER | varchar(128) | NO |
说明
|
| SEQ_NUM | bigint(20) | NO | 事务中的语句序号
说明
|
| NETWORK_WAIT_TIME | bigint(20) unsigned | YES | 所有 Network 类事件的总时间，单位为微秒。 |
| PLSQL_COMPILE_TIME | bigint(20) | NO | PL 编译用时。
说明
|
| INSERT_DUPLICATE_ROW_COUNT | bigint(20) | NO | 记录 insertup 或者 replace into 时重复行数的数量。
说明
|
| USER_CLIENT_PORT | bigint(20) | NO | 用于展示客户端端口号。
说明
|
| TRANS_STATUS | varchar(256) | NO | 用于展示显示开启事务或隐式开启事务或不开启事务。
说明 |
| TX_TABLE_READ_CNT | bigint(20) | NO | 查询读事务状态表的次数。
说明在 V4.5.x 版本中，该字段从 V4.5.0 版本开始引入。 |
| OUTROW_LOB_CNT | bigint(20) | NO | 查询过程中，读取到的 outrow lob 列的数量。
说明在 V4.5.x 版本中，该字段从 V4.5.0 版本开始引入。 |
| COMMIT_TIME | bigint(20) | NO | 表示事务中触发提交 SQL 的提交耗时。若 SQL 未触发提交，默认值为 0。
说明在 V4.6.x 版本中，该字段从 V4.6.0 版本开始引入。 |
| OBJECT_STORAGE_READS | bigint(20) | NO | 取值恒为 0。
说明在 V4.6.x 版本中，该字段从 V4.6.0 版本开始引入。 |
| PARENT_TRACE_ID | varchar(128) | YES | 当前 SQL 的父层 SQL 所对应的 trace_id。
说明在 V4.6.x 版本中，该字段从 V4.6.0 版本开始引入。 |
重要的事件间隔关系
该视图中重要的事件对应字段 ELAPSED_TIME、REQUEST_TIME、NET_WAIT_TIME、QUEUE_TIME、DECODE_TIME、GET_PLAN_TIME、EXECUTE_TIME 和 COMMIT_TIME 的关系如下图所示：
查询示例
查询当前 OBServer 节点的每一次 SQL 请求的来源、执行状态等统计信息。
obclient [oceanbase]> SELECT * FROM oceanbase.V$OB_SQL_AUDIT LIMIT 1\G
查询结果如下：
*************************** 1. row ***************************
SVR_IP: 172.xx.xxx.xxx
SVR_PORT: 2882
REQUEST_ID: 1572864
SQL_EXEC_ID: 17540886
TRACE_ID: xxxxxxxx-xxxxxxxx-0-0
SID: 3221624675
CLIENT_IP: 0.0.0.0
CLIENT_PORT: 0
TENANT_ID: 1002
TENANT_NAME: sys
EFFECTIVE_TENANT_ID: 1002
USER_ID: 200001
USER_NAME: root
USER_GROUP: 0
USER_CLIENT_IP: 0.0.0.0
DB_ID: 201001
DB_NAME: oceanbase
SQL_ID: B7A6FA97FEC98C06F9586D23935AC4C6
QUERY_SQL:
PLAN_ID: 0
AFFECTED_ROWS: 0
RETURN_ROWS: 0
PARTITION_CNT: 0
RET_CODE: 0
QC_ID: 0
DFO_ID: 0
SQC_ID: 0
WORKER_ID: 0
EVENT: exec inner sql wait
P1TEXT: wait inner sql class
P1: 0
P2TEXT: inner session id
P2: 4611686018440954357
P3TEXT:
P3: 0
LEVEL: 0
WAIT_CLASS_ID: 100
WAIT_CLASS#: 0
WAIT_CLASS: OTHER
STATE: WAITED SHORT TIME
WAIT_TIME_MICRO: 6
TOTAL_WAIT_TIME_MICRO: 6
TOTAL_WAITS: 1
RPC_COUNT: 0
PLAN_TYPE: 0
IS_INNER_SQL: 1
IS_EXECUTOR_RPC: 0
IS_HIT_PLAN: 0
REQUEST_TIME: 1749805123144451
ELAPSED_TIME: 72
NET_TIME: 0
NET_WAIT_TIME: 0
QUEUE_TIME: 0
DECODE_TIME: 0
GET_PLAN_TIME: 66
EXECUTE_TIME: 6
APPLICATION_WAIT_TIME: 0
CONCURRENCY_WAIT_TIME: 0
USER_IO_WAIT_TIME: 0
SCHEDULE_TIME: 0
ROW_CACHE_HIT: 0
BLOOM_FILTER_CACHE_HIT: 0
BLOCK_CACHE_HIT: 0
DISK_READS: 0
RETRY_CNT: 0
TABLE_SCAN: 0
CONSISTENCY_LEVEL: -1
MEMSTORE_READ_ROW_COUNT: 0
SSSTORE_READ_ROW_COUNT: 0
DATA_BLOCK_READ_CNT: 0
DATA_BLOCK_CACHE_HIT: 0
INDEX_BLOCK_READ_CNT: 0
INDEX_BLOCK_CACHE_HIT: 0
BLOCKSCAN_BLOCK_CNT: 0
BLOCKSCAN_ROW_CNT: 0
PUSHDOWN_STORAGE_FILTER_ROW_CNT: 0
REQUEST_MEMORY_USED: 73728
EXPECTED_WORKER_COUNT: 0
USED_WORKER_COUNT: 0
SCHED_INFO: NULL
FUSE_ROW_CACHE_HIT: 0
PS_CLIENT_STMT_ID: -1
PS_INNER_STMT_ID: -1
TX_ID: 314178
SNAPSHOT_VERSION: 0
REQUEST_TYPE: 1
IS_BATCHED_MULTI_STMT: 0
OB_TRACE_INFO: NULL
PLAN_HASH: 0
LOCK_FOR_READ_TIME: 0
PARAMS_VALUE:
RULE_NAME:
PARTITION_HIT: 1
TX_INTERNAL_ROUTING: 0
TX_STATE_VERSION: 0
FLT_TRACE_ID:
PL_TRACE_ID: NULL
PLSQL_EXEC_TIME: 0
FORMAT_SQL_ID:
STMT_TYPE: START_TRANS
TOTAL_MEMSTORE_READ_ROW_COUNT: 0
TOTAL_SSSTORE_READ_ROW_COUNT: 0
PROXY_USER:
SEQ_NUM: 1749805123102551
NETWORK_WAIT_TIME: 0
PLSQL_COMPILE_TIME: 0
INSERT_DUPLICATE_ROW_COUNT: 0
USER_CLIENT_PORT: 0
TRANS_STATUS: Enable committable transaction
CCL_RULE_ID: 0
CCL_MATCH_TIME: 0
TX_TABLE_READ_CNT: 0
OUTROW_LOB_CNT: 0
COMMIT_TIME: 0
OBJECT_STORAGE_READS: 0
