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.3

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

Download PDF

What is ODP? Overview Use OBD to deploy ODP Deploy ODP by using OCP Deploy ODP by using the CLI Deployment modes Basic operations View and modify parameters Parameter summary binlog_service_ip cache_cleaner_clean_interval check_tenant_locality_change client_max_connections client_max_memory_size client_session_id_version 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 compression_algorithm config_server_refresh_interval congestion_fail_window congestion_failure_threshold congestion_retry_interval connection_diagnosis_option connect_observer_max_retries current_local_config_version default_buffer_water_mark default_inactivity_timeout delay_exit_time delay_update_entry_interval detect_server_timeout digest_sql_length enable_abort_conn_info enable_async_log enable_async_pull_location_cache enable_bad_route_reject enable_binlog_service enable_cached_server enable_causal_order_read enable_client_connection_lru_disconnect enable_client_ip_checkout enable_client_ssl enable_cloud_full_username enable_cluster_checkout enable_compression_protocol enable_congestion enable_connection_diagnosis enable_extra_prometheus_metric enable_flow_control enable_full_username enable_get_rslist_remote enable_index_route enable_monitor_stat enable_ob_protocol_v2 enable_ob_protocol_v2_with_client enable_partition_table_route enable_performance_mode enable_pl_route enable_primary_zone enable_prometheus enable_proxy_scramble enable_qa_mode enable_qos enable_read_write_split enable_report_session_stats enable_reroute enable_sequence_prefetch enable_server_ssl enable_standby enable_stat enable_strict_stat_time enable_sync_all_stats enable_syslog_file_compress enable_syslog_wf enable_trace enable_trace_stats enable_trans_detail_stats enable_transaction_internal_routing enable_transaction_split enable_weak_reroute enable_xa_route fetch_proxy_bin_random_time fetch_proxy_bin_timeout flow_consumer_reenable_threshold flow_event_queue_threshold flow_high_water_mark flow_low_water_mark hot_upgrade_exit_timeout hot_upgrade_failure_retries hot_upgrade_rollback_timeout idc_list_refresh_interval ignore_local_config internal_cmd_mem_limited ldg_info_refresh_interval log_cleanup_interval log_dir_size_threshold
OceanBase logo

The Unified Distributed Database for the Al 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.3
iconOceanBase Database Proxy
V 4.2.3
  • 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

ODP Enterprise Edition V4.2.1

Last Updated:2025-05-16 10:11:43  Updated
share
What is on this page
V4.2.1 BP2 hotfix5
Version information
Bug fixes
V4.2.1 BP2 hotfix4
Version information
Bug fixes
V4.2.1 BP2 hotfix3
Version information
Bug fixes
V4.2.1 BP2 hotfix2
Version information
Overview
Bug fixes
V4.2.1 BP2 hotfix1
Version information
Bug fixes
V4.2.1 BP2
Version information
Overview
Bug fixes
V4.2.1 BP1
Version information
Bug fixes
V4.2.1
Version information
Overview
Feature updates
Bug fixes

folded

share

V4.2.1 BP2 hotfix5

Version information

  • Release date: March 11, 2025

  • Version: V4.2.1 BP2 hotfix5

  • RPM version: obproxy-4.2.1.0-72025031114

Bug fixes

Fixed the issue where an INSERT request initiated to a partitioned table is routed to a non-leader node in OceanBase Database V1.4.x.

V4.2.1 BP2 hotfix4

Version information

  • Release date: June 04, 2024

  • Version: V4.2.1 BP2 hotfix4

  • RPM version: obproxy-4.2.1.0-20240604114727

Bug fixes

  • Fixed the issue where startup parameters specified by the -o option may be lost upon initial startup.
  • Fixed the issue where the statistics collected in Prometheus monitoring are smaller than actual values.
  • Fixed the issue where garbled characters exist in output strings of Prometheus.
  • Fixed the issue of inaccurate routing in scenarios where enable_cached_server is set to True, if proxy_idc_name is not obtained upon login.
  • Fixed the issue where OceanBase Database Proxy (ODP) hangs due to multi-level binlog configurations, causing connections to time out and terminate.
  • Fixed the issue where Prometheus outputs incorrect database names.

V4.2.1 BP2 hotfix3

Version information

  • Release date: February 22, 2024

  • Version: V4.2.1 BP2 hotfix3

  • RPM version: obproxy-4.2.1.0-20240229214253

Bug fixes

  • Fixed the issue where an OceanBase cluster cannot be connected from Visual Studio for Windows.
  • Fixed the issue where an SSL connection cannot be established by the C# driver with the database.

V4.2.1 BP2 hotfix2

Version information

  • Release date: December 20, 2023

  • Version: V4.2.1 BP2 hotfix2

  • RPM version: obproxy-4.2.1.0-20231220145047

Overview

Address-level binlog configurations are supported.

Bug fixes

  • Fixed the issue where a core dump is generated for ODP in a scenario where the prepared statement (PS) protocol is enabled in an Advanced RISC Machine (Arm) environment.
  • Fixed the issue where memory leaks occur when the memory usage of ODP increases slowly, causing a force restart.
  • Fixed the issue where the performance of queries based on the specified cursor fetch size is poor when ODP connects to an OceanBase cluster.
  • Fixed the issue where, when the number of connections exceeds the specified value, ODP only returns an error packet but does not close connections, and the client does not close connections either, causing connection leaks.
  • Fixed the issue where, when ODP V4.x is used for OceanBase Database V3.x, ODP cannot connect to the new primary cluster after a cluster failover.

V4.2.1 BP2 hotfix1

Version information

  • Release date: October 17, 2023

  • Version: V4.2.1 BP2 hotfix1

  • RPM version: obproxy-4.2.1.0-20231017181929

Bug fixes

  • Fixed the issue where ODP exits due to a PS memory leak.

  • Fixed the issue where the connection to the Binlog service fails occasionally after the high availability feature is enabled for ODP.

  • Modified the disaster recovery check criteria for the Binlog service.

  • Fixed the issue where an exception occurs during the update of the configuration table when global settings are configured by specifying the cluster_name parameter.

  • Fixed the issue where the value of the is_partition_hit parameter in the diagnostic log is true (which is expected to be false) due to inaccurate SQL routing.

V4.2.1 BP2

Version information

  • Release date: September 05, 2023

  • Version: V4.2.1 BP2

  • RPM version: obproxy-4.2.1.0-20230905194130

Overview

Binlog service address change is supported.

Bug fixes

  • Fixed the issue where, after enable_ldg is enabled in an Arm environment, a core dump is generated for ODP while simulating a network failure on a node by using iptables.

  • Fixed the issue where disconnection occurs during running.

  • Fixed the issue where disconnection occurs due to expired cluster information in a binlog request scenario.

  • Fixed the issue where ODP falls into an infinite loop after login fails in some scenarios.

  • Fixed the issue of memory bloat in routing diagnostics.

V4.2.1 BP1

Version information

  • Release date: August 11, 2023

  • Version: V4.2.1 BP1

  • RPM version: obproxy-4.2.1.0-20230811111811

Bug fixes

  • Fixed the issue where the show columns from db_name.table_name statement cannot be correctly recognized.

  • Fixed the issue where parameters cannot be persisted in the routing diagnostics feature.

  • Fixed the issue of memory leaks in the routing diagnostics feature.

  • Fixed the issue where the process exits during a hot upgrade.

  • Fixed the issue where the process exits because the memory of ODP is used up due to a memory leak in the connection diagnostics feature.

V4.2.1

Version information

  • Release date: July 12, 2023

  • Version: V4.2.1

  • RPM version: obproxy-4.2.1.0-20230712162726

Overview

ODP V4.2.1 is a Long-term Supported (LTS) version of V4.2.x.

Feature updates

  • Automatic session synchronization verification is supported.

  • Access to a cluster by using its alias is supported.

  • The GB18030 2022 character set is supported.

  • The Show Trace feature is supported. For more information, see Show Trace.

  • Forwarding of binlog-related statements is supported.

  • The routing diagnostics feature is supported. For more information, see Overview.

  • The connection diagnostics feature is supported.

  • The forcible encryption attribute is supported for SSL.

  • The general connection initialization mechanism is supported.

  • A latency threshold is supported for weak-consistency reads. For more information, see Follower latency threshold.

Bug fixes

  • Fixed the issue of ODP disconnection.

  • Fixed the issue where an error is expected but the operation succeeds when a tenant-level parameter is deleted.

  • Fixed the issue where you cannot configure multiple values when you update a parameter.

  • Fixed the issue where the allowlist contains invalid CIDR blocks.

  • Fixed the issue where the operation of inserting data into a table is hung when the utf16 character set is used.

  • Fixed the issue where the error "received malformed packet" is returned when the root@proxysys account is used to log in to ODP after ODP is restarted.

  • Fixed the issue where disconnection occurs when an IP address specified in the comment is enclosed with double quotation marks (").

  • Fixed the issue where, when a three-segment connection string, in which the primary address of the cluster hosting the standby tenant is specified as the database IP address and the name of the cluster hosting the primary tenant is appended to the tenant name in the login username, is used for database connection, the primary tenant is connected but the error Cannot execute statement in a READ ONLY transaction is returned, indicating that data write is not supported.

  • Fixed the issue where the parsing module of ODP may cause memory leaks.

  • Fixed the issue where the performance deteriorates after some system variables are modified.

  • Fixed the issue where distributed transaction routing must be used for the select CONNECTION_ID() statement.

  • Fixed the issue of PL disconnection during calls.

  • Fixed the issue where the connection to ODP is disconnected if the OK packet contains the last_insert_id field.

  • Fixed the issue where ODP must support the attribute value 0 when reading connection attributes.

Previous topic

ODP Enterprise Edition V4.2.2
Last

Next topic

ODP Enterprise Edition V4.1.0
Next
What is on this page
V4.2.1 BP2 hotfix5
Version information
Bug fixes
V4.2.1 BP2 hotfix4
Version information
Bug fixes
V4.2.1 BP2 hotfix3
Version information
Bug fixes
V4.2.1 BP2 hotfix2
Version information
Overview
Bug fixes
V4.2.1 BP2 hotfix1
Version information
Bug fixes
V4.2.1 BP2
Version information
Overview
Bug fixes
V4.2.1 BP1
Version information
Bug fixes
V4.2.1
Version information
Overview
Feature updates
Bug fixes