OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Database

SQL - V4.3.1

    Download PDF

    OceanBase logo

    The Unified Distributed Database for the AI Era.

    Follow Us
    Products
    OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
    Resources
    DocsBlogWhite PaperLive DemosTraining & CertificationTicket
    Company
    About OceanBaseTrust CenterLegalPartnerContact Us
    Follow Us

    © OceanBase 2026. All rights reserved

    Cloud Service AgreementPrivacy PolicySecurity
    Contact Us
    Document Feedback
    1. Documentation Center
    2. OceanBase Database
    3. SQL
    4. V4.3.1
    iconOceanBase Database
    SQL - V 4.3.1
    Databases
    • OceanBase Database
    • OceanBase Cloud
    • OceanBase Tugraph
    • Interactive Tutorials
    • OceanBase Best Practices
    Tools
    • OceanBase Cloud Platform
    • OceanBase Migration Service
    • OceanBase Developer Center
    • OceanBase Migration Assessment
    • OceanBase Admin Tool
    • OceanBase Loader and Dumper
    • OceanBase Deployer
    • Kubernetes operator for OceanBase
    • OceanBase Diagnostic Tool
    • OceanBase Binlog Service
    Connectors and Middleware
    • OceanBase Database Proxy
    • Embedded SQL in C for OceanBase
    • OceanBase Call Interface
    • OceanBase Connector/C
    • OceanBase Connector/J
    • OceanBase Connector/ODBC
    • OceanBase Connector/NET
    SQL
    KV
    • V 4.6.0
    • V 4.4.2
    • V 4.3.5
    • V 4.3.3
    • V 4.3.1
    • V 4.3.0
    • V 4.2.5
    • V 4.2.2
    • V 4.2.1
    • V 4.2.0
    • V 4.1.0
    • V 4.0.0
    • V 3.1.4 and earlier

    V$OB_PROCESSLIST

    Last Updated:2026-04-15 08:25:15  Updated
    Share
    What is on this page
    Purpose
    Columns
    Sample query
    References

    folded

    Share

    Note

    This view is introduced since OceanBase Database V4.0.0.

    Purpose

    The V$OB_PROCESSLIST view displays information about sessions on the current OBServer node.

    Columns

    Column
    Type
    Nullable?
    Description
    SVR_IP varchar(46) NO The IP address of the OBServer node.
    SVR_PORT bigint(20) NO The port number of the OBServer node.
    SQL_PORT bigint(20) NO The SQL port number.
    ID bigint(20) unsigned NO The ID of the session.
    USER varchar(32) NO The username.
    HOST varchar(128) NO The hostname of the client. For example, if you connect to the OBServer node by using an OceanBase Database Proxy (ODP), the value is the host address of the ODP.
    DB varchar(128) NO The name of the database accessed.
    TENANT varchar(128) NO The name of the tenant accessed.
    COMMAND varchar(4096) NO The type of the command being executed in the session.
    TIME bigint(20) NO The execution time of the current command, in seconds. If a retry occurs, the value is cleared and recalculated.
    TOTAL_TIME bigint(20) NO The total execution time of the current command, in seconds. If a retry occurs, the value will not be cleared.
    STATE varchar(128) NO The current session status.
    INFO varchar(262143) NO The command that is being executed.
    PROXY_SESSID bigint(20) unsigned NO The ODP session ID is displayed if the client is an ODP.
    MASTER_SESSID bigint(20) unsigned NO The ID of the master session, which is used to concatenate multiple sub-sessions of the same SQL statement.
    USER_CLIENT_IP varchar(46) NO The IP address of the user client.
    USER_HOST varchar(128) NO The hostname of the user client.
    RETRY_CNT bigint(20) NO The number of retries of the current command.
    RETRY_INFO bigint(20) NO The retry information about the current command. Generally, the value is the error code of the last retry.
    SQL_ID varchar(32) NO The ID of the SQL statement.
    TRANS_ID bigint(20) unsigned NO The ID of the transaction.
    THREAD_ID bigint(20) unsigned NO The ID of the thread.
    SSL_CIPHER varchar(4096) NO The encryption password.
    TRACE_ID varchar(64) NO The trace ID.
    TRANS_STATE varchar(32) NO The status of the transaction. Valid values:
    • IDLE: The transaction is in the idle state, indicating that the transaction is not started.
    • ACTIVE: The transaction is explicitly initiated. A transaction can be started explicitly using statements such as START TRANSACTION and BEGIN.
    • IMPLICIT_ACTIVE: The transaction is implicitly initiated. In autocommit = on mode, a transaction is initiated after executing DML or other data-modifying statements.
    • ROLLBACK_SAVEPOINT: The transaction is rolling back to a savepoint.
    • IN_TERMINATE: The transaction is being terminated, including termination due to internal reasons and user-initiated termination (for example, executing the COMMIT or ROLLBACK statement).
    • ABORTED: The transaction is internally terminated or rolled back due to an exception.
    • ROLLED_BACK: The transaction is rolled back.
    • COMMIT_TIMEOUT: The transaction commit has timed out.
    • COMMIT_UNKNOWN: The transaction commit status is unknown.
    • COMMITTED: The transaction is successfully committed.
    ACTION varchar(4096) NO The name of the operation being executed that is set by calling the DBMS_APPLICATION_INFO.SET_ACTION procedure.
    MODULE varchar(4096) NO The name of the module that is set by calling the DBMS_APPLICATION_INFO.SET_MODULE procedure.
    CLIENT_INFO varchar(4096) NO The client information set by the DBMS_APPLICATION_INFO.SET_CLIENT_INFO procedure.
    LEVEL bigint(20) NO The diagnostic information monitoring level for end-to-end diagnostics of the session. For example, the value 1 indicates that level-1 diagnostic information is monitored.

    Note

    This column is introduced since OceanBase Database V4.2.1.

    SAMPLE_PERCENTAGE bigint(20) NO The sampling rate for end-to-end diagnostics of the session. For example, the value 50 indicates that diagnostic information is sampled at a rate of 50%.

    Note

    This column is introduced since OceanBase Database V4.2.1.

    RECORD_POLICY varchar(32) NO The diagnostic information recording strategy for end-to-end diagnostics of the session. Three strategies are supported:
    • ALL: All sampling-enabled traces that meet specified sampling conditions are recorded in the log file immediately after each span ends.
    • ONLY_SLOW_QUERY: Among sampling-enabled traces that meet specified sampling conditions, only traces of slow queries are recorded in the log file, and other traces are discarded. For this strategy, trace logs are recorded after a request ends and is determined as a slow query. In the proxy, the root span, namely the transaction-level span, is immediately recorded when a slow query is detected.
    • SAMPLE_AND_SLOW_QUERY: Among sampling-enabled traces that meet specified sampling conditions, those meeting any of the following conditions are recorded in the log file:
      1. The hidden parameter _print_sample_ppm is used for sampling at a rate of 0.01% and the sampling result meets specified conditions.
      2. The condition specified in the ONLY_SLOW_QUERY strategy is met.
      In this mode, the timing for logging varies based on the situation. Specifically, if Condition 1 is met, it is marked on the client that the trace log will be forcibly recorded and this information will be transferred to subsequent components on the link. If Condition 2 is met, the timing for logging is the same as that in the ONLY_SLOW_QUERY strategy.

    Note

    This column is introduced since OceanBase Database V4.2.1.

    LB_VID bigint(20) NO The VPC ID of the load balancing service if you directly connect to the database in a public cloud by using the load balancing service. Otherwise, the value is NULL.

    Note

    This column is introduced since OceanBase Database V4.2.1.

    LB_VIP varchar(46) NO The IP address used by the client to connect to the load balancing service if you directly connect to the database in a public cloud by using the load balancing service. Otherwise, the value is NULL.

    Note

    This column is introduced since OceanBase Database V4.2.1.

    LB_VPORT bigint(20) NO The port used by the client to connect to the load balancing service if you directly connect to the database in a public cloud by using the load balancing service. Otherwise, the value is NULL.

    Note

    This column is introduced since OceanBase Database V4.2.1.

    IN_BYTES bigint(20) NO The inbound traffic of the session, in bytes.

    Note

    This column is introduced since OceanBase Database V4.2.1.

    OUT_BYTES bigint(20) NO The outbound traffic of the session, in bytes.

    Note

    This column is introduced since OceanBase Database V4.2.1.

    TOTAL_CPU_TIME bigint(21) NO The CPU time spent on executing the current statement, in seconds.

    Note

    This column is introduced since OceanBase Database V4.3.1.

    Sample query

    Query information about sessions on the current OBServer node.

    obclient> select * from oceanbase.V$OB_PROCESSLIST limit 1 \G
    

    The query result is as follows:

    *************************** 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 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 (0.006 sec)
    

    References

    • GV$OB_PROCESSLIST
    • Methods

    Previous topic

    V$OB_PLAN_CACHE_STAT
    Last

    Next topic

    V$OB_PS_ITEM_INFO
    Next
    What is on this page
    Purpose
    Columns
    Sample query
    References