---
title: "V$OB_PROCESSLIST - OceanBase 数据库 V4.2.2 | OceanBase 文档中心"
description: V$OB_PROCESSLIST 说明 从 V4.0.0 版本开始引入。 功能描述 展示本 OBServer 节点的会话信息。 字段说明 字段名称 类型 是否可以为 NULL 描述 SVR_IP varchar(46) NO 服务器 IP 地址 SVR_PORT bigint(20) NO 服务器端口号 SQL_PO…
---
切换语言

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

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

# V$OB_PROCESSLIST

更新时间：2026-04-10 11:58:37

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.2/zh-CN/700.reference/700.system-views/400.system-view-of-mysql-mode/300.performance-view-of-mysql-mode/4900.v-ob_processlist-of-mysql-mode.md)

#### 说明

从 V4.0.0 版本开始引入。

## 功能描述

展示本 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 |
| USER | varchar(32) | NO | 用户名 |
| HOST | varchar(128) | NO | 客户端主机名称 （如：通过 obproxy 连接则为 obproxy 的 HOST 地址） |
| DB | varchar(128) | NO | 访问的 Database 名称 |
| TENANT | varchar(128) | NO | 访问的租户名称 |
| COMMAND | varchar(4096) | NO | 当前执行的命令类型 |
| TIME | bigint(20) | NO | 当前命令执行时间，单位是秒。如果命令发生重试，会清零后重新计算 |
| TOTAL_TIME | bigint(20) | NO | 当前命令执行总时间，单位是秒。如果命令发生重试，不会清零 |
| STATE | varchar(128) | NO | 当前会话状态 |
| INFO | varchar(262143) | NO | 展示当前正在执行的命令 |
| PROXY_SESSID | bigint(20) unsigned | NO | 如果客户端是 obproxy，本列展示 proxy session id |
| MASTER_SESSID | bigint(20) unsigned | NO | 主 session id，用于串联同一个 SQL 的多个子 session |
| USER_CLIENT_IP | varchar(46) | NO | 用户客户端 IP |
| USER_HOST | varchar(128) | NO | 用户客户端主机名 |
| 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) | NO | 加密密码名称 |
| TRACE_ID | varchar(64) | NO | Trace ID |
| TRANS_STATE | varchar(32) | NO | 事务状态（如果会话上没有事务，则显示为空）：   - `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) | NO | 通过调用 DBMS_APPLICATION_INFO.SET_ACTION procedure 设置的当前执行操作的名称 |
| MODULE | varchar(4096) | NO | 通过调用 DBMS_APPLICATION_INFO.SET_MODULE procedure 设置的当前执行操作的名称 |
| CLIENT_INFO | varchar(4096) | NO | 由 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) | NO | 如果是公有云环境上通过负载均衡直接连接数据库，则本列显示的是负载均衡服务的 VPC ID。否则显示为 NULL   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| LB_VIP | varchar(46) | NO | 如果是公有云环境上通过负载均衡直接连接数据库，则本列显示的是客户端连接负载均衡服务的 IP。否则显示为 NULL   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| LB_VPORT | bigint(20) | NO | 如果是公有云环境上通过负载均衡直接连接数据库，则本列显示的是客户端连接负载均衡服务的端口。否则显示为 NULL   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| IN_BYTES | bigint(20) | NO | 表示该会话的流入流量，单位为 byte   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| OUT_BYTES | bigint(20) | NO | 表示该会话的流出流量，单位为 byte   #### 说明    该字段从 V4.2.1 版本开始引入。 |

## 查询示例

查询本 OBServer 节点的会话信息。

```shell
obclient [oceanbase]> SELECT * FROM oceanbase.V$OB_PROCESSLIST LIMIT 1 \G

```

查询结果如下：

```shell
*************************** 1. row ***************************
           SVR_IP: xx.xx.xx.xx
         SVR_PORT: 2882
         SQL_PORT: 2881
               ID: 3221487789
             USER: root
             HOST: xx.xx.xx.xx:59697
               DB: oceanbase
           TENANT: sys
          COMMAND: Query
             TIME: 0.005439
       TOTAL_TIME: 0.005512
            STATE: ACTIVE
             INFO: SELECT * FROM oceanbase.V$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: 1E2AE144FE8CB891AA8138FC74EDCAB2
         TRANS_ID: 0
        THREAD_ID: 19932
       SSL_CIPHER: NULL
         TRACE_ID: YBXXXXXXXX-000XXXXXXXXXXX-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: 845
        OUT_BYTES: 15567
   TOTAL_CPU_TIME: 0
1 row in set

```

## 相关视图或文档

- [GV$OB_PROCESSLIST](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000509523)
 - [全链路追踪方法](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000507950)

 上一篇 下一篇 ![有帮助](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) 咨询热线
