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

- 中文站 - 简体中文
- 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/500.system-view-of-oracle-mode/300.performance-view-of-oracle-mode/4500.v-ob_processlist-of-oracle-mode.md)

#### 说明

从 V4.0.0 版本开始引入。

## 功能描述

展示本 OBServer 节点的会话信息。

## 字段说明

| 字段名称 | 类型 | 是否可以为 NULL | 描述 |
| --- | --- | --- | --- |
| SVR_IP | VARCHAR2(46) | NO | 服务器 IP 地址 |
| SVR_PORT | NUMBER(38) | NO | 服务器端口号 |
| SQL_PORT | NUMBER(38) | NO | SQL 端口号 |
| ID | NUMBER(38) | NO | 会话 ID |
| USER | CHAR(193) | NO | 用户名 |
| HOST | VARCHAR2(128) | NO | 客户端主机名称 (如：通过 obproxy 连接则为 obproxy 的 HOST 地址） |
| DB | VARCHAR2(128) | YES | 访问的 Database 名称 |
| TENANT | VARCHAR2(128) | NO | 访问的租户名称 |
| COMMAND | VARCHAR2(4096) | NO | 当前执行的命令类型 |
| TIME | NUMBER(38) | NO | 当前命令执行时间，单位是秒。如果命令发生重试，会清零后重新计算 |
| TOTAL_TIME | NUMBER(38) | NO | 当前命令执行总时间，单位是秒。如果命令发生重试，不会清零 |
| STATE | VARCHAR2(128) | YES | 当前会话状态 |
| INFO | VARCHAR2(262143) | YES | 展示当前正在执行的命令 |
| PROXY_SESSID | NUMBER(38) | YES | 如果客户端是 obproxy，本列展示 proxy session id |
| MASTER_SESSID | NUMBER(38) | YES | 主 session id，用于串联同一个 SQL 的多个子 session |
| USER_CLIENT_IP | VARCHAR2(46) | YES | 用户客户端 IP |
| USER_HOST | VARCHAR2(128) | YES | 用户客户端主机名 |
| RETRY_CNT | NUMBER(38) | NO | 当前命令的重试次数 |
| RETRY_INFO | NUMBER(38) | NO | 当前命令的重试信息，一般为最后一次重试的错误码 |
| SQL_ID | VARCHAR2(32) | NO | SQL ID 信息 |
| TRANS_ID | NUMBER(38) | NO | 事务 ID |
| THREAD_ID | NUMBER(38) | NO | 线程 ID |
| SSL_CIPHER | VARCHAR2(4096) | YES | 加密密码名称 |
| TRACE_ID | VARCHAR2(64) | YES | Trace ID |
| TRANS_STATE | VARCHAR2(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 | VARCHAR2(4096) | YES | 通过调用 DBMS_APPLICATION_INFO.SET_ACTION procedure 设置的当前执行操作的名称 |
| MODULE | VARCHAR2(4096) | YES | 通过调用 DBMS_APPLICATION_INFO.SET_MODULE procedure 设置的当前执行操作的名称 |
| CLIENT_INFO | VARCHAR2(4096) | YES | 由 DBMS_APPLICATION_INFO.SET_CLIENT_INFO 过程设置的信息 |
| LEVEL | NUMBER(38) | NO | 表示该 Session 的全链路追踪监控级别。例如，1 表示 level 为 1 的诊断信息   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| SAMPLE_PERCENTAGE | NUMBER(38) | NO | 表示该 Session 的全链路追踪采样频率。 例如，50 表示以 50% 的概率进行诊断信息的采样   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| RECORD_POLICY | VARCHAR2(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 | NUMBER(38) | NO | 如果是公有云环境上通过负载均衡直接连接数据库，则本列显示的是负载均衡服务的 VPC ID。否则显示为 NULL   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| LB_VIP | VARCHAR2(46) | NO | 如果是公有云环境上通过负载均衡直接连接数据库，则本列显示的是客户端连接负载均衡服务的 IP。否则显示为 NULL   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| LB_VPORT | NUMBER(38) | NO | 如果是公有云环境上通过负载均衡直接连接数据库，则本列显示的是客户端连接负载均衡服务的端口。否则显示为 NULL   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| IN_BYTES | NUMBER(38) | NO | 表示该会话的流入流量，单位为 byte   #### 说明    该字段从 V4.2.1 版本开始引入。 |
| OUT_BYTES | NUMBER(38) | NO | 表示该会话的流出流量，单位为 byte   #### 说明    该字段从 V4.2.1 版本开始引入。 |

## 查询示例

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

```shell
obclient [SYS]> SELECT * FROM SYS.V$OB_PROCESSLIST WHERE ROWNUM < = 1 \G

```

查询结果如下：

```shell
*************************** 1. row ***************************
           SVR_IP: xx.xx.xx.xx
         SVR_PORT: 2882
         SQL_PORT: 2881
               ID: 3221487790
             USER: SYS
             HOST: xx.xx.xx.xx:62298
               DB: SYS
           TENANT: oracle001
          COMMAND: Query
             TIME: 0
       TOTAL_TIME: 0
            STATE: ACTIVE
             INFO: SELECT * FROM SYS.V$OB_PROCESSLIST WHERE ROWNUM < = 1
     PROXY_SESSID: NULL
    MASTER_SESSID: NULL
   USER_CLIENT_IP: xx.xx.xx.xx
        USER_HOST: %
        RETRY_CNT: 0
       RETRY_INFO: 0
           SQL_ID: E4E8B8057D4B3A5A2366C3267143D803
         TRANS_ID: 0
        THREAD_ID: 20625
       SSL_CIPHER: NULL
         TRACE_ID: YBXXXXXXXXXX-000XXXXXXXXXXX-0-0
      TRANS_STATE: NULL
           ACTION: NULL
           MODULE: NULL
      CLIENT_INFO: NULL
            LEVEL: 1
SAMPLE_PERCENTAGE: 10
    RECORD_POLICY: SAMPLE_AND_SLOW_QUERY
           LB_VID: NULL
           LB_VIP: NULL
         LB_VPORT: NULL
         IN_BYTES: 750
        OUT_BYTES: 4225
1 row in set

```

## 相关视图或文档

- [GV$OB_PROCESSLIST](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000508752)
 - [全链路追踪方法](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) 咨询热线
