--- title: "V$OB_SQL_AUDIT - OceanBase 数据库 V4.2.1 | OceanBase 文档中心" description: V$OB_SQL_AUDIT 说明 从 V4.0.0 版本开始引入。 功能描述 视图 V$OB_SQL_AUDIT 展示当前 OBServer 节点的每一次 SQL 请求的来源、执行状态等统计信息。该视图是按照租户拆分的，除了系统租户，其他租户不能跨租户查询。 字段说明 字段名称 类型 是否可以为 NULL 描述 S… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.1 LTS # V$OB_SQL_AUDIT 更新时间：2026-04-16 13:11:33 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/300.performance-view-of-sys-tenant/6900.v-sql_audit-of-sys-tenant.md) #### 说明 从 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 | Session 连接 ID | | CLIENT_IP | varchar(46) | NO | - 当客户端通过 ODP 与 OBServer 节点连接时，表示转发请求的 ODP 的 IP - 当客户端直接与 OBServer 节点连接时，表示发送请求的客户端的 IP | | 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 | 执行结果返回码： - 0：表示没有错误，语句成功执行 - 其他返回码：表示 OceanBase 错误码。有关错误码的详细介绍，请参见 [错误码](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218679) | | 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 | 执行计划类型： - local - remote - distribute | | 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 | MemStore 中的读行数 | | SSSTORE_READ_ROW_COUNT | bigint(20) | NO | 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) | 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： - `-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 | 请求对应的事务 ID | | SNAPSHOT_VERSION | bigint(20) | NO | SQL语句使用的读快照版本 | | REQUEST_TYPE | bigint(20) | NO | 请求对应的类型： - 0：表示非法 - 1：表示是一个内部请求 - 2：表示是一个本地请求，例如，Local 计划 - 3：表示远程请求 - 4：表示分布式请求 - 5：表示 SQL 的 Prepare 请求 - 6：表示 SQL 的 Execute Stmt 请求 | | 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 | - 若获得 DAS 执行计划，命中本地 Partition 则为 1，没有命中则为 0。 - 若未获得 DAS 计划，默认为 1。 #### 说明 该字段从 V4.1.0 版本开始引入。 | | TX_INTERNAL_ROUTING | bigint(20) | NO | 表示当前事务是否启用了事务路由： - 0：未启用事务路由，语句只能路由到事务开始时的 OBServer 节点上。 - 1：启用事务路由，事务内的语句可以由代理 Proxy 按照最优的方式路由。 #### 说明 - 该字段从 V4.1.0 版本开始引入。 - OBProxy 从 V4.1.0 版本开始支持该功能。 | | TX_STATE_VERSION | bigint(20) unsigned | NO | 当事务路由开启后，执行语句后事务状态若发生变化，则版本号递增；若未发生变化，则版本号不变 #### 说明 - 该字段从 V4.1.0 版本开始引入。 - OBProxy 从 V4.1.0 版本开始支持该功能。 | | FLT_TRACE_ID | varchar(1024) | NO | 表示该条记录全链路追踪的 trace_id，如果为空，则说明没有被全链路追踪监控。该字段是Uuid，不同于 Trace。其表示形式类似于：`000600d6-a5de-038c-6c80-df07e4e79149` #### 说明 该字段从 V4.2.1 版本开始引入。 | | NETWORK_WAIT_TIME | bigint(20) unsigned | NO | 所有 Network 类事件的总时间，单位为微秒 #### 说明 该字段从 V4.2.1 BP5 版本开始引入。 | ## 查询示例 查询所有 OBServer 节点的每一次 SQL 请求的来源、执行状态等统计信息。 ```shell obclient [oceanbase]> SELECT * FROM oceanbase.V$OB_SQL_AUDIT LIMIT 1\G ``` 查询结果如下： ```shell *************************** 1. row *************************** SVR_IP: 172.xx.xx.xx SVR_PORT: 2882 REQUEST_ID: 26500000 SQL_EXEC_ID: 88598565 TRACE_ID: YB4XXXXXXXXX-000XXXXXXXXXXXX-0-0 SID: 1 CLIENT_IP: 0.0.0.0 CLIENT_PORT: 0 TENANT_ID: 1 TENANT_NAME: sys EFFECTIVE_TENANT_ID: 1 USER_ID: 200001 USER_NAME: root USER_GROUP: 0 USER_CLIENT_IP: 0.0.0.0 DB_ID: 201001 DB_NAME: oceanbase SQL_ID: 6F3109B2EDC153980E1722318E4F6240 QUERY_SQL: SELECT value FROM __all_zone where zone='zone1' and name='status' PLAN_ID: 2154 AFFECTED_ROWS: 0 RETURN_ROWS: 1 PARTITION_CNT: 1 RET_CODE: 0 QC_ID: 0 DFO_ID: 0 SQC_ID: 0 WORKER_ID: 0 EVENT: P1TEXT: P1: 0 P2TEXT: P2: 0 P3TEXT: P3: 0 LEVEL: 0 WAIT_CLASS_ID: 100 WAIT_CLASS#: 0 WAIT_CLASS: OTHER STATE: MAX_WAIT TIME ZERO WAIT_TIME_MICRO: 0 TOTAL_WAIT_TIME_MICRO: 0 TOTAL_WAITS: 0 RPC_COUNT: 0 PLAN_TYPE: 1 IS_INNER_SQL: 1 IS_EXECUTOR_RPC: 0 IS_HIT_PLAN: 1 REQUEST_TIME: 1722228881087256 ELAPSED_TIME: 84 NET_TIME: 0 NET_WAIT_TIME: 0 QUEUE_TIME: 0 DECODE_TIME: 0 GET_PLAN_TIME: 47 EXECUTE_TIME: 37 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: 3 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: 0 SNAPSHOT_VERSION: 1722228880952534346 REQUEST_TYPE: 1 IS_BATCHED_MULTI_STMT: 0 OB_TRACE_INFO: NULL PLAN_HASH: 4393714422578885891 LOCK_FOR_READ_TIME: 0 PARAMS_VALUE: RULE_NAME: PARTITION_HIT: 1 TX_INTERNAL_ROUTING: 0 TX_STATE_VERSION: 0 FLT_TRACE_ID: NETWORK_WAIT_TIME: 0 1 row in set ``` ## 相关视图或文档 - [GV$OB_SQL_AUDIT](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000219776) - [全链路追踪](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218369) 上一篇 下一篇 ![有帮助](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) 咨询热线