--- title: "GV$OB_PROCESSLIST - OceanBase 数据库 V4.2.5 | OceanBase 文档中心" description: GV$OB_PROCESSLIST 说明 该视图从 V4.0.0 版本开始引入。 功能描述 视图 GV$OB_PROCESSLIST 用于展示租户所在的所有 OBServer 节点的会话信息。 字段说明 字段名称 类型 是否可以为 NULL 描述 SVR_IP varchar(46) NO 服务器 IP 地址 SVR… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.5 LTS # GV$OB_PROCESSLIST 更新时间：2026-04-15 20:46:29 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/300.performance-view-of-sys-tenant/2300.gv-ob_processlist-of-sys-tenant.md) #### 说明 该视图从 V4.0.0 版本开始引入。 ## 功能描述 视图 `GV$OB_PROCESSLIST` 用于展示租户所在的所有 OBServer 节点的会话信息。 ## 字段说明 | 字段名称 | 类型 | 是否可以为 NULL | 描述 | | --- | --- | --- | --- | | SVR_IP | varchar(46) | NO | 服务器 IP 地址 | | SVR_PORT | bigint(20) | NO | 服务器端口号 | | SQL_PORT | bigint(20) | NO | SQL 端口号 | | ID | bigint(20) unsigned | NO | 会话 ID 对于 V4.2.x 版本： - V4.2.5 BP5 之前版本： 在所有连接方式（直连模式/ODP 模式）下，该字段均表示 Server Session ID。 - V4.2.5 BP5 及之后版本： - 在直连模式下： 该字段表示 Server Session ID。 - 在 ODP 模式下： - 当 ODP 中的配置项 `client_session_id_version = 2` 时，该字段表示 Client Session ID。 - 当 `client_session_id_version = 1` 时，该字段表示 Server Session ID。 | | USER | varchar(32) | NO | 用户名 | | HOST | varchar(128) | NO | 客户端 IP:PORT | | DB | varchar(128) | YES | 访问的 Database 名称 | | TENANT | varchar(128) | NO | 访问的租户名称 | | COMMAND | varchar(4096) | NO | 当前执行的命令类型 | | TIME | bigint(20) | NO | 当前命令执行时间，单位是秒。如果命令发生重试，会清零后重新计算 | | TOTAL_TIME | bigint(20) | NO | 根据是否执行命令： - 如果是在接收请求后且在返回客户端之前，表示从接收请求到当前时间的间隔 - 如果是非接受请求情况下的状态, 表示当前状态的持续时间 单位为秒 #### 说明 在 V4.2.5 之前版本，该字段的语义为“当前命令的执行总时间，在命令重试时不会被清零”。 | | STATE | varchar(128) | YES | 当前会话状态 | | INFO | varchar(262143) | YES | 展示当前正在执行的命令 | | PROXY_SESSID | bigint(20) unsigned | YES | 如果客户端是 obproxy，本列展示 proxy session id | | MASTER_SESSID | bigint(20) unsigned | YES | 主 session id，用于串联同一个 SQL 的多个子 session | | USER_CLIENT_IP | varchar(46) | YES | 用户客户端 IP | | USER_HOST | varchar(128) | YES | 用户客户端主机名 | | RETRY_CNT | bigint(20) | NO | 当前命令的重试次数 | | RETRY_INFO | bigint(20) | NO | 当前命令的重试信息，一般为最后一次重试的错误码 | | SQL_ID | varchar(32) | NO | SQL ID 信息 | | TRANS_ID | bigint(20) unsigned | NO | 事务 ID | | THREAD_ID | bigint(20) unsigned | NO | 线程 ID | | SSL_CIPHER | varchar(4096) | YES | 加密密码名称 | | TRACE_ID | varchar(64) | YES | Trace ID | | TRANS_STATE | varchar(32) | YES | 事务状态（如果会话上没有事务，则显示为空）： - `IDLE`：空闲状态，表示事务未开始。 - `ACTIVE`：事务显式开启。通过 `START TRANSACTION`、`BEGIN` 等语句显式开启。 - `IMPLICIT_ACTIVE`：事务隐式开启，`autocommit = on` 模式下，执行 DML 等修改数据的语句后事务被开启。 - `ROLLBACK_SAVEPOINT`：事务正在回滚至保存点。 - `IN_TERMINATE`：事务正在结束，包括内部原因导致的结束和用户发起的结束事务（例如，执行 `COMMIT`、`ROLLBACK` 语句）。 - `ABORTED`：事务因发生异常而内部终止或回滚。 - `ROLLED_BACK`：事务已经被回滚。 - `COMMIT_TIMEOUT`：事务提交超时。 - `COMMIT_UNKNOWN`：事务提交结果未知。 - `COMMITTED`：事务已经成功提交。 | | ACTION | varchar(4096) | YES | 通过调用 DBMS_APPLICATION_INFO.SET_ACTION procedure 设置的当前执行操作的名称 | | MODULE | varchar(4096) | YES | 通过调用 DBMS_APPLICATION_INFO.SET_MODULE procedure 设置的当前执行操作的名称 | | CLIENT_INFO | varchar(4096) | YES | 由 DBMS_APPLICATION_INFO.SET_CLIENT_INFO 过程设置的信息 | | LEVEL | bigint(20) | NO | 表示该 Session 的全链路追踪监控级别。例如，1 表示 level 为 1 的诊断信息 #### 说明 该字段从 V4.2.1 版本开始引入。 | | SAMPLE_PERCENTAGE | bigint(20) | NO | 表示该 Session 的全链路追踪采样频率。 例如，50 表示以 50% 的概率进行诊断信息的采样 #### 说明 该字段从 V4.2.1 版本开始引入。 | | RECORD_POLICY | varchar(32) | NO | 表示该 Session 的全链路追踪记录策略。主要支持以下 3 种策略： - ALL：所有命中采样打开 Trace 的 Trace 打点信息，均打印到日志文件中，并且是在每个 span 结束时，就打印到日志文件中。 - ONLY_SLOW_QUERY：所有命中采样打开 Trace 的 Trace 打点信息中，属于 Slow Query 的请求 Trace，会打印到日志文件中，其余均丢弃，对于该打印策略，Trace 日志的打印时机是在请求结束被判定为 Slow Query 后才打印，在 Proxy 中，对于根 span，也就是事务级别的 span，是在发现有 Slow Query 时，才会打印根 span。 - SAMPLE_AND_SLOW_QUERY：所有命中采样打开 Trace 的 Trace 打点信息中，满足以下条件的 Trace 均打印到日志文件： 1. 当使用隐藏配置项 `_print_sample_ppm` 进行万分之一的概率采样，且只有当采样结果被选中时，才会将其打印到日志中 2. 满足 ONLY_SLOW_QUERY 模式下打印条件该模式下，日志打印时机也不是在 span 结束时，如果满足条件1，则在客户端就被标记为该 Trace 日志会被强制打印，并且该信息会传递到后面的链路组件：如果满足条件 2，则打印时机与 ONLY_SLOW_QUERY 相同。 #### 说明 该字段从 V4.2.1 版本开始引入。 | | LB_VID | bigint(20) | YES | 如果是公有云环境上通过负载均衡直接连接数据库，则本列显示的是负载均衡服务的 VPC ID。否则显示为 NULL #### 说明 该字段从 V4.2.1 版本开始引入。 | | LB_VIP | varchar(46) | YES | 如果是公有云环境上通过负载均衡直接连接数据库，则本列显示的是客户端连接负载均衡服务的 IP。否则显示为 NULL #### 说明 该字段从 V4.2.1 版本开始引入。 | | LB_VPORT | bigint(20) | YES | 如果是公有云环境上通过负载均衡直接连接数据库，则本列显示的是客户端连接负载均衡服务的端口。否则显示为 NULL #### 说明 该字段从 V4.2.1 版本开始引入。 | | IN_BYTES | bigint(20) | NO | 表示该会话的流入流量，单位为 byte #### 说明 该字段从 V4.2.1 版本开始引入。 | | OUT_BYTES | bigint(20) | NO | 表示该会话的流出流量，单位为 byte #### 说明 该字段从 V4.2.1 版本开始引入。 | | USER_CLIENT_PORT | bigint(20) | NO | 客户端地址信息 #### 说明 该字段从 V4.2.3 版本开始引入。 | | PROXY_USER | varchar(128) | YES | - 代理用户登录场景，返回代理用户的名称。 - 非代理用户登录场景，显示为空。 #### 说明 该字段从 V4.2.3 版本开始引入。 | | SERVICE_NAME | varchar(64) | YES | 该 Session 由哪个服务名创建，值为 `NULL` 表示该 Session 不是由服务名创建 #### 说明 该字段从 V4.2.4 版本开始引入。 | | TOTAL_CPU_TIME | bigint(21) | NO | 当前命令执行 CPU 使用时间，单位为秒 #### 说明 - 在 V4.3.x 版本中，该字段从 V4.3.1 版本开始引入。 - 在 V4.2.1 版本中，该字段从 V4.2.1 BP5 版本开始引入；在 V4.2.x 其他版本中，该字段从 V4.2.5 版本开始引入。 | | TOP_INFO | varchar(262143) | YES | 展示执行中 SQL 所在的顶层 PL 语句信息 #### 说明 - 在 V4.3.x 版本中，该字段从 V4.3.3 版本开始引入。 - 在 V4.2.1 版本中，该字段从 V4.2.1 BP9 版本开始引入；在 V4.2.x 其他版本中，该字段从 V4.2.5 版本开始引入。 | | MEMORY_USAGE | bigint(20) | YES | 单条 SQL 语句当前使用的内存大小，单位为字节 #### 说明 对于 V4.2.5 版本，该字段从 V4.2.5 BP2版本开始引入。 | ## 查询示例 查询租户所在的所有 OBServer 节点的会话信息。 ```shell obclient [oceanbase]> SELECT * FROM oceanbase.GV$OB_PROCESSLIST LIMIT 1\G ``` 查询结果如下： ```shell *************************** 1. row *************************** SVR_IP: xx.xx.xx.xx SVR_PORT: 2882 SQL_PORT: 2881 ID: 3221711494 USER: root HOST: xx.xx.xx.xx:25892 DB: oceanbase TENANT: mysql001 COMMAND: Query TIME: 0.065386 TOTAL_TIME: 0.065444 STATE: ACTIVE INFO: SELECT * FROM oceanbase.GV$OB_PROCESSLIST LIMIT 1 PROXY_SESSID: NULL MASTER_SESSID: NULL USER_CLIENT_IP: xx.xx.xx.xx USER_HOST: % RETRY_CNT: 0 RETRY_INFO: 0 SQL_ID: 536F00E9EFCC3725E2239429AB69C94D TRANS_ID: 0 THREAD_ID: 26478 SSL_CIPHER: NULL TRACE_ID: YB42AC1E87E1-000XXXXXXXXXXXC-0-0 TRANS_STATE: ACTION: MODULE: CLIENT_INFO: LEVEL: 1 SAMPLE_PERCENTAGE: 10 RECORD_POLICY: SAMPLE_AND_SLOW_QUERY LB_VID: NULL LB_VIP: NULL LB_VPORT: NULL IN_BYTES: 448 OUT_BYTES: 0 USER_CLIENT_PORT: 25892 PROXY_USER: SERVICE_NAME: NULL TOTAL_CPU_TIME: 0 TOP_INFO: NULL MEMORY_USAGE: 270336 1 row in set ``` ## 相关视图或文档 - [V$OB_PROCESSLIST](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001501368) - [查看租户会话](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001499651) 上一篇 下一篇 ![有帮助](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) 咨询热线