OceanBase logo

OceanBase

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

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

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

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 Proxy

V4.2.2

  • What is ODP?
  • Installation and deployment
    • Deployment modes
    • Deploy ODP by using OCP
    • Overview
    • Deploy ODP by using the CLI
    • Use OBD to deploy ODP
  • Basic operations
  • Configuration parameter
    • Parameter summary
    • View and modify parameters
    • Parameters that take effect dynamically
      • check_tenant_locality_change
      • client_max_connections
      • client_sock_option_flag_out
      • client_tcp_keepcnt
      • client_tcp_keepidle
      • client_tcp_keepintvl
      • client_tcp_user_timeout
      • cluster_count_high_water_mark
      • cluster_expire_time
      • config_server_refresh_interval
      • congestion_fail_window
      • congestion_failure_threshold
      • congestion_retry_interval
      • current_local_config_version
      • default_buffer_water_mark
      • default_inactivity_timeout
      • digest_sql_length
      • enable_async_log
      • enable_async_pull_location_cache
      • enable_binlog_service
      • enable_causal_order_read
      • enable_client_ip_checkout
      • enable_cluster_checkout
      • enable_congestion
      • enable_connection_diagnosis
      • enable_extra_prometheus_metric
      • enable_full_username
      • enable_ob_protocol_v2
      • enable_pl_route
      • enable_primary_zone
      • enable_prometheus
      • enable_proxy_scramble
      • enable_qos
      • enable_reroute
      • enable_sequence_prefetch
      • enable_standby
      • enable_stat
      • enable_syslog_file_compress
      • enable_trace
      • enable_trace_stats
      • enable_trans_detail_stats
      • enable_transaction_internal_routing
      • enable_weak_reroute
      • fetch_proxy_bin_random_time
      • fetch_proxy_bin_timeout
      • flow_high_water_mark
      • hot_upgrade_exit_timeout
      • hot_upgrade_failure_retries
      • idc_list_refresh_interval
      • ignore_local_config
      • internal_cmd_mem_limited
      • log_cleanup_interval
      • long_async_task_timeout
      • max_syslog_file_time
      • metadb_server_state_refresh_interval
      • monitor_stat_dump_interval
      • monitor_stat_high_threshold
      • need_convert_vip_to_tname
      • net_config_poll_timeout
      • obproxy_read_only
      • obproxy_sys_password
      • observer_sys_password
      • partition_location_expire_relative_time
      • prometheus_sync_interval
      • proxy_mem_limited
      • proxy_route_policy
      • qa_mode_mock_public_cloud_slb_addr
      • qos_stat_clean_interval
      • routing_cache_mem_limited
      • sequence_entry_expire_time
      • sequence_fail_retry_count
      • sequence_prefetch_threshold
      • server_detect_mode
      • server_routing_mode
      • server_tcp_keepcnt
      • server_tcp_user_timeout
      • short_async_task_timeout
      • skip_proxyro_check
      • slow_proxy_process_time_threshold
      • slow_query_time_threshold
      • sock_packet_mark_out
      • sock_recv_buffer_size_out
      • sql_table_cache_mem_limited
      • stat_dump_interval
      • syslog_level
      • tenant_location_valid_time
      • username_separator
      • xflush_log_level
      • binlog_service_ip
      • delay_exit_time
      • delay_update_entry_interval
      • enable_abort_conn_info
      • enable_cached_server
      • enable_client_ssl
      • enable_cloud_full_username
      • enable_flow_control
      • enable_get_rslist_remote
      • enable_partition_table_route
      • enable_performance_mode
      • enable_read_write_split
      • enable_report_session_stats
      • enable_server_ssl
      • enable_sharding
      • enable_strict_stat_time
      • enable_sync_all_stats
      • flow_consumer_reenable_threshold
      • flow_event_queue_threshold
      • ldg_info_refresh_interval
      • max_log_file_size
      • min_congested_connect_timeout
      • min_keep_congestion_interval
      • monitor_cost_ms_unit
      • monitor_item_max_idle_period
      • monitor_log_level
      • monitor_stat_low_threshold
      • enable_get_rslist_remote
      • enable_performance_mode
      • enable_read_write_split
      • enable_report_session_stats
      • enable_server_ssl
      • enable_strict_stat_time
      • enable_sync_all_stats
      • min_keep_congestion_interval
      • monitor_log_level
      • monitor_stat_low_threshold
      • observer_query_timeout_delta
      • proxy_idc_name
      • query_digest_time_threshold
      • read_stale_retry_interval
      • refresh_idc_list
      • server_tcp_keepintvl
      • tunnel_request_size_threshold
      • connect_observer_max_retries
      • enable_transaction_split
      • obproxy_force_parallel_query_dop
      • flow_low_water_mark
      • normal_pl_update_threshold
      • route_diagnosis_level
      • sock_send_buffer_size_out
      • monitor_item_limit
      • ssl_attributes
      • server_state_refresh_interval
      • max_syslog_file_count
      • log_dir_size_threshold
      • hot_upgrade_rollback_timeout
      • proxy_local_cmd
      • server_detect_refresh_interval
      • ob_max_read_stale_time
      • sqlaudit_mem_limited
      • server_tcp_keepidle
      • qos_stat_item_limit
      • target_db_server
      • enable_ob_protocol_v2_with_client
      • slow_transaction_time_threshold
      • detect_server_timeout
      • enable_index_route
      • sock_option_flag_out
      • connection_diagnosis_option
      • cache_cleaner_clean_interval
      • enable_xa_route
      • client_max_memory_size
      • request_buffer_length
      • enable_bad_route_reject
      • skip_proxy_sys_private_check
      • enable_qa_mode
      • stat_table_sync_interval
      • obproxy_read_consistency
      • proxy_primary_zone_name
      • enable_monitor_stat
      • enable_compression_protocol
      • monitor_stat_middle_threshold
      • log_file_percentage
      • enable_client_connection_lru_disconnect
      • sql_table_cache_expire_relative_time
    • Parameters that take effect after a restart
      • ip_listen_mode
      • enable_global_ps_cache
      • local_bound_ipv6_ip
      • rootservice_list
      • rootservice_cluster_name
      • obproxy_config_server_url
      • stack_size
      • block_thread_num
      • listen_port
      • enable_strict_kernel_release
      • shard_scan_thread_num
      • local_bound_ip
      • grpc_thread_num
      • prometheus_listen_port
      • enable_cpu_isolate
      • grpc_client_num
      • work_thread_num
      • enable_cpu_topology
      • prometheus_cost_ms_unit
      • net_accept_threads
      • task_thread_num
      • automatic_match_work_thread
  • Connection management
    • Principles
    • Connection diagnostics
    • Client session
    • Session status synchronization
    • Server session
  • Data routing
    • Factors affecting data routing
    • ODP routing
    • Follower latency threshold
    • Read/Write separation
    • Intra-tenant routing
      • IP address-based routing
      • Global index table-based routing for strong-consistency reads
      • Partitioned table-based routing for strong-consistency reads
      • Replication table-based routing for strong-consistency reads
      • Strategy-based routing
      • Distributed transaction routing
      • Primary zone-based routing for strong-consistency reads
      • Forcible routing
      • Overview
      • Rerouting
  • High availability mechanism
    • High availability testing
    • Overview
    • High availability of ODP services
    • High availability of OceanBase Database
  • Security and protocols
  • Operation and maintenance
    • Troubleshooting
      • Troubleshooting logic
      • Monitoring logs
    • Performance analysis
    • Show Trace
    • Routing diagnostics
      • Overview
      • Examples
      • Obtain diagnostic information
      • Diagnostic point troubleshooting
        • PARTITION_ENTRY_LOOKUP_DONE
        • PARTITION_ID_CALC_DONE
        • ROUTE_POLICY
        • HANDLE_RESPONSE
        • ROUTE_INFO
        • EXPR_PARSE
        • Overview
        • CONGESTION_CONTROL
        • RESOLVE_TOKEN
        • SQL_PARSE
        • FETCH_TABLE_RELATED_DATA
        • LOCATION_CACHE_LOOKUP
        • ROUTINE_ENTRY_LOOKUP_DONE
        • RESOLVE_EXPR
        • CALC_ROWID
        • CALC_PARTITION_ID
        • TABLE_ENTRY_LOOKUP_DONE
        • RETRY
  • Release Notes
    • Versioning rules
    • Enterprise Edition
      • V3.2
        • ODP V3.2.11
        • ODP Enterprise Edition V3.2.3.5
      • V4.0
        • ODP Enterprise Edition V4.0.0
      • V4.1
        • ODP Enterprise Edition V4.1.0
      • V4.2
        • ODP Enterprise Edition V4.2.2
        • ODP Enterprise Edition V4.2.1
    • Community Edition
      • V4.0
        • ODP Community Edition V4.0.0
      • V4.2
        • ODP Community Edition V4.2.0
        • ODP Community Edition V4.2.1
      • V4.1
        • ODP Community Edition V4.1.0

Download PDF

What is ODP? Deployment modes Deploy ODP by using OCP Overview Deploy ODP by using the CLI Use OBD to deploy ODP Basic operations Parameter summary View and modify parameters check_tenant_locality_change client_max_connections client_sock_option_flag_out client_tcp_keepcnt client_tcp_keepidle client_tcp_keepintvl client_tcp_user_timeout cluster_count_high_water_mark cluster_expire_time config_server_refresh_interval congestion_fail_window congestion_failure_threshold congestion_retry_interval current_local_config_version default_buffer_water_mark default_inactivity_timeout digest_sql_length enable_async_log enable_async_pull_location_cache enable_binlog_service enable_causal_order_read enable_client_ip_checkout enable_cluster_checkout enable_congestion enable_connection_diagnosis enable_extra_prometheus_metric enable_full_username enable_ob_protocol_v2 enable_pl_route enable_primary_zone enable_prometheus enable_proxy_scramble enable_qos enable_reroute enable_sequence_prefetch enable_standby enable_stat enable_syslog_file_compress enable_trace enable_trace_stats enable_trans_detail_stats enable_transaction_internal_routing enable_weak_reroute fetch_proxy_bin_random_time fetch_proxy_bin_timeout flow_high_water_mark hot_upgrade_exit_timeout hot_upgrade_failure_retries idc_list_refresh_interval ignore_local_config internal_cmd_mem_limited log_cleanup_interval long_async_task_timeout max_syslog_file_time metadb_server_state_refresh_interval monitor_stat_dump_interval monitor_stat_high_threshold need_convert_vip_to_tname net_config_poll_timeout obproxy_read_only obproxy_sys_password observer_sys_password partition_location_expire_relative_time prometheus_sync_interval proxy_mem_limited proxy_route_policy qa_mode_mock_public_cloud_slb_addr qos_stat_clean_interval routing_cache_mem_limited sequence_entry_expire_time sequence_fail_retry_count sequence_prefetch_threshold server_detect_mode server_routing_mode server_tcp_keepcnt server_tcp_user_timeout short_async_task_timeout skip_proxyro_check slow_proxy_process_time_threshold slow_query_time_threshold sock_packet_mark_out sock_recv_buffer_size_out sql_table_cache_mem_limited stat_dump_interval syslog_level tenant_location_valid_time username_separator xflush_log_level binlog_service_ip delay_exit_time delay_update_entry_interval
OceanBase logo

The Unified Distributed Database for the AI Era.

Follow Us
Products
OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
Resources
DocsBlogLive DemosTraining & Certification
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 Proxy
  3. V4.2.2
iconOceanBase Database Proxy
V 4.2.2
  • V 4.3.4
  • V 4.3.3
  • V 4.3.2
  • V 4.3.1
  • V 4.3.0
  • V 4.2.3
  • V 4.2.2
  • V 4.2.0 and earlier

Server session

Last Updated:2024-03-07 08:37:59  Updated
share
What is on this page
View a server session
Terminate a server session

folded

share

This topic describes several general operations performed on a server session, which is established between OceanBase Database Proxy (ODP) and an OBServer node.

View a server session

At present, it is not supported to view a server session through ODP. You can log in to the sys tenant of the OceanBase cluster as the root user and view all OBServer nodes in the cluster. Then, you can directly connect to the target OBServer node and view the server session.

  1. Log in to the sys tenant of the OceanBase cluster as the root user and view all OBServer nodes in the cluster.

    obclient> select * from oceanbase.__all_server;
    +----------------------------+----------------------------+------------+----------+----+------+------------+-----------------+--------+-----------------------+--------------------------------------------------------------------------+-----------+--------------------+--------------+----------------+
    | gmt_create                 | gmt_modified               | svr_ip     | svr_port | id | zone | inner_port | with_rootserver | status | block_migrate_in_time | build_version                                                            | stop_time | start_service_time | first_sessid | with_partition |
    +----------------------------+----------------------------+------------+----------+----+------+------------+-----------------+--------+-----------------------+--------------------------------------------------------------------------+-----------+--------------------+--------------+----------------+
    | 2023-02-28 15:45:53.230044 | 2023-02-28 15:46:25.577180 | 10.10.10.1 |     2882 |  3 | z3   |       2881 |               1 | ACTIVE |                     0 | 4.1.0.0_1-703037f0b023c8ffa880258463b25b1735cf27b3(Feb 28 2023 13:21:21) |         0 |   1677570376568330 |            0 |              1 |
    | 2023-02-28 15:45:53.197477 | 2023-02-28 15:46:25.534448 | 10.10.10.2 |     2882 |  2 | z2   |       2881 |               0 | ACTIVE |                     0 | 4.1.0.0_1-703037f0b023c8ffa880258463b25b1735cf27b3(Feb 28 2023 13:21:21) |         0 |   1677570376522994 |            0 |              1 |
    | 2023-02-28 15:45:53.113870 | 2023-02-28 15:46:25.098607 | 10.10.10.3 |     2882 |  1 | z1   |       2881 |               0 | ACTIVE |                     0 | 4.1.0.0_1-703037f0b023c8ffa880258463b25b1735cf27b3(Feb 28 2023 13:21:21) |         0 |   1677570378084150 |            0 |              1 |
    +----------------------------+----------------------------+------------+----------+----+------+------------+-----------------+--------+-----------------------+--------------------------------------------------------------------------+-----------+--------------------+--------------+----------------+
    3 rows in set
    
  2. Select the target OBServer node and directly connect to it. The following sample code directly connects to the OBServer node with the IP address 10.10.10.1 and the SQL port 2881.

    [admin@test001 ~]$ obclient -h10.10.10.1 -P2881 -uroot@sys -p -Doceanbase -A
    
  3. Run the show processlist; command to view all sessions of the current OBServer node.

    obclient> show processlist;
    

    Returned result:

    +------------+---------+------------------+-----------+---------+------+--------+------------------+
    | Id         | User    | Host             | db        | Command | Time | State  | Info             |
    +------------+---------+------------------+-----------+---------+------+--------+------------------+
    | 3221812197 | root    | 10.10.10.1:48563 | NULL      | Query   |    0 | ACTIVE | show processlist |
    | 3222117829 | proxyro | 10.10.10.1:37876 | oceanbase | Sleep   |    6 | SLEEP  | NULL             |
    | 3221709618 | root    | 10.10.10.1:51390 | NULL      | Sleep   |  831 | SLEEP  | NULL             |
    +------------+---------+------------------+-----------+---------+------+--------+------------------+
    3 rows in set
    

Terminate a server session

At present, ODP does not provide a command to directly terminate a server session. You can terminate a server session by directly connecting to the target OBServer node.

  1. Log in to the sys tenant of the OceanBase cluster as the root user and view all OBServer nodes in the cluster.

    obclient> select * from oceanbase.__all_server;
    +----------------------------+----------------------------+------------+----------+----+------+------------+-----------------+--------+-----------------------+--------------------------------------------------------------------------+-----------+--------------------+--------------+----------------+
    | gmt_create                 | gmt_modified               | svr_ip     | svr_port | id | zone | inner_port | with_rootserver | status | block_migrate_in_time | build_version                                                            | stop_time | start_service_time | first_sessid | with_partition |
    +----------------------------+----------------------------+------------+----------+----+------+------------+-----------------+--------+-----------------------+--------------------------------------------------------------------------+-----------+--------------------+--------------+----------------+
    | 2023-02-28 15:45:53.230044 | 2023-02-28 15:46:25.577180 | 10.10.10.1 |     2882 |  3 | z3   |       2881 |               1 | ACTIVE |                     0 | 4.1.0.0_1-703037f0b023c8ffa880258463b25b1735cf27b3(Feb 28 2023 13:21:21) |         0 |   1677570376568330 |            0 |              1 |
    | 2023-02-28 15:45:53.197477 | 2023-02-28 15:46:25.534448 | 10.10.10.2 |     2882 |  2 | z2   |       2881 |               0 | ACTIVE |                     0 | 4.1.0.0_1-703037f0b023c8ffa880258463b25b1735cf27b3(Feb 28 2023 13:21:21) |         0 |   1677570376522994 |            0 |              1 |
    | 2023-02-28 15:45:53.113870 | 2023-02-28 15:46:25.098607 | 10.10.10.3 |     2882 |  1 | z1   |       2881 |               0 | ACTIVE |                     0 | 4.1.0.0_1-703037f0b023c8ffa880258463b25b1735cf27b3(Feb 28 2023 13:21:21) |         0 |   1677570378084150 |            0 |              1 |
    +----------------------------+----------------------------+------------+----------+----+------+------------+-----------------+--------+-----------------------+--------------------------------------------------------------------------+-----------+--------------------+--------------+----------------+
    3 rows in set
    
  2. Directly connect to the target OBServer node. The following sample code directly connects to the OBServer node with the IP address 10.10.10.1 and SQL port 2881.

    [admin@test001 ~]$ obclient -h10.10.10.1 -P2881 -uroot@sys -p -Doceanbase -A
    
  3. Run the show processlist; command to view all sessions of the current OBServer node.

    obclient> show processlist;
    

    Returned result:

    +------------+---------+------------------+-----------+---------+------+--------+------------------+
    | Id         | User    | Host             | db        | Command | Time | State  | Info             |
    +------------+---------+------------------+-----------+---------+------+--------+------------------+
    | 3221812197 | root    | 10.10.10.1:48563 | NULL      | Query   |    0 | ACTIVE | show processlist |
    | 3222117829 | proxyro | 10.10.10.1:37876 | oceanbase | Sleep   |    6 | SLEEP  | NULL             |
    | 3221709618 | root    | 10.10.10.1:51390 | NULL      | Sleep   |  831 | SLEEP  | NULL             |
    +------------+---------+------------------+-----------+---------+------+--------+------------------+
    3 rows in set
    
  4. Run the kill <id> command to terminate the current session whose Id is 3221812197.

    obclient> kill 3221812197;
    ERROR 2013 (HY000): Lost connection to MySQL server during query
    

Previous topic

Client session
Last

Next topic

Connection diagnostics
Next
What is on this page
View a server session
Terminate a server session