云控制台登录 / 注册

免费试用

本地部署

OceanBase 分布式数据库

首批通过分布式安全可靠测评，为关键业务系统打造

OceanBase 集中式数据库

集中式架构，兼具性能与成本优势的集中式数据库

OceanBase 社区版

兼容 MySQL 的单机分布式一体化开源数据库

OceanBase seekdb

为现代 AI 应用打造的开源混合搜索数据库

云上部署

OB Cloud

一体化云数据库，打造面向多云的一致性体验

一体机

OceanBase 数据库一体机

软硬一体，提供极致性能与高可靠性保障

OceanBase AI 一体机

基于 OceanBase AI Stack 的智能一体机

工具

一体化关键能力

面向关键业务负载的事务处理能力，保障大规模业务稳定运行与数据零丢失

AP 实时分析

原生支持事务与分析融合，低延迟洞察业务数据，驱动智能决策与敏捷运营

AI 现代负载

湖库一体管理多模态数据离在线处理，AI 原生支撑 Agent 规模化应用

OceanBase 一体化分布式数据库

助力银行完成各类核心业务系统升级

寿险、产险核心系统升级的更佳选择

助力200+零售行业客户规模化落地

百亿级卡券业务的“单库双擎”架构升级

800个测试用例选定分布式数据库

先难后易，核心系统数据库升级复盘

行业案例

交通银行

核心数据库的“分布式革命”

中国移动

B域核心CRM&BOSS近乎零改造分布式升级

理想

打造领先的智能制造系统和自动驾驶体验

演讲实录

中国联通

集团应用分布式数据库覆盖B/O/M域

国泰海通

智能推送系统稳定支撑单日亿级消息处理量

中国联合航空

中国首款机票盲盒背后的数据库力量

用户实践

北京银行

最快速度完成40余套系统国产数据库升级

维沃移动通信有限公司

替换 MySQL 分库分表，探索成本效益最优

数据库大规模运维体系建设及落地实践

神州信息 x OceanBase 银行核心系统

长亮科技 x OceanBase 新核心系统

中电金信 x OceanBase 金融分布式核心系统

天阳科技 x OceanBase 贷记卡方案

易诚互动 x OceanBase 手机银行方案

恒生 x OceanBase UF3.0/O45/TA/估值方案

商业发行版

云树®数据库软件 ActionDB

服务

支持与服务

提交工单

软件下载

学习

开发者

资料

金融核心系统数据库升级路径与场景实践

人社关键业务数据库一体化升级实践

快速上手

汇聚常见产品使用问题案例

Demo与实验，感受 OceanBase 的核心能力与应用场景

OceanBase 最佳实践

了解 OceanBase 分布式数据库的架构与系统原理

技术解析｜用户实践｜社区月报

电子书｜视频课程｜在线培训

应用开发Demo | 数据开发与集成工具

快速答疑｜常见问题｜技术交流

Meetup ｜技术公开课

查看源码｜贡献代码｜建议反馈

社区组织｜社区用户贡献｜开发者贡献

第五届OceanBase数据库大赛

从故障处理到性能调优：OceanBase资深DBA进阶培训

切换语言

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

username_separator - 数据库代理 V4.3.2 | OceanBase 文档中心

文档反馈

V4.3.2

ODP 概述
安装部署
基本操作
配置参数
- 配置项说明
- 配置项总览
- 全局配置项
  - automatic_match_work_thread
  - block_thread_num
  - 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
  - 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_auto_restart
  - enable_bad_route_reject
  - enable_binlog_service
  - enable_cached_server
  - enable_causal_order_read
  - enable_client_connection_lru_disconnect
  - enable_client_ip_checkout
  - enable_cluster_checkout
  - enable_compression_protocol
  - enable_congestion
  - enable_connection_diagnosis
  - enable_cpu_isolate
  - enable_cpu_topology
  - enable_cross_shard_txn
  - enable_extra_prometheus_metric
  - enable_flow_control
  - enable_full_link_trace
  - enable_full_username
  - enable_get_rslist_remote
  - enable_global_ps_cache
  - enable_index_route
  - enable_monitor_stat
  - enable_ob_protocol_v2
  - enable_obproxy_rpc_service
  - enable_partition_table_route
  - enable_performance_mode
  - enable_pl_route
  - enable_primary_zone
  - enable_prometheus
  - enable_proxy_scramble
  - enable_qa_mode
  - enable_qos
  - enable_report_session_stats
  - enable_reroute
  - enable_sequence_prefetch
  - enable_sharding
  - enable_single_leader_node_routing
  - enable_standby
  - enable_stat
  - enable_strict_kernel_release
  - 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_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
  - grpc_client_num
  - grpc_thread_num
  - hot_upgrade_exit_timeout
  - hot_upgrade_failure_retries
  - hot_upgrade_rollback_timeout
  - idc_list_refresh_interval
  - ignore_local_config
  - internal_cmd_mem_limited
  - ip_listen_mode
  - is_need_skip_delay_interval_schema_changed
  - ldg_info_refresh_interval
  - listen_port
  - local_bound_ip
  - local_bound_ipv6_ip
  - 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
  - need_convert_vip_to_tname
  - net_accept_threads
  - net_config_poll_timeout
  - normal_pl_update_threshold
  - obproxy_config_server_url
  - obproxy_sys_password
  - partition_location_expire_relative_time
  - prometheus_cost_ms_unit
  - prometheus_listen_port
  - prometheus_sync_interval
  - protocol_diagnosis_level
  - proxy_cluster
  - proxy_hot_upgrade_check_interval
  - proxy_id
  - proxy_info_check_interval
  - proxy_local_cmd
  - proxy_mem_limited
  - qa_mode_mock_public_cloud_slb_addr
  - qos_stat_clean_interval
  - qos_stat_item_limit
  - refresh_idc_list
  - refresh_json_config
  - refresh_rslist
  - request_buffer_length
  - rootservice_list
  - rpc_async_task_thread_num
  - routing_cache_mem_limited
  - rpc_async_pull_batch_max_size
  - rpc_async_pull_batch_max_times
  - rpc_async_pull_batch_wait_interval
  - rpc_ctx_expire_time
  - rpc_enable_async_analyze
  - rpc_enable_async_pull_batch_tablets
  - rpc_enable_direct_expire_route_entry
  - rpc_enable_congestion
  - rpc_enable_global_index
  - rpc_enable_force_srv_black_list
  - rpc_enable_parallel_handler
  - rpc_enable_reroute
  - rpc_force_srv_black_list
  - rpc_enable_retry_request_info_log
  - rpc_max_response_batch_size
  - rpc_max_request_batch_size
  - rpc_listen_port
  - rpc_net_timeout_base
  - rpc_max_server_table_entry_num
  - rpc_period_task_interval
  - rpc_request_timeout
  - rpc_redis_default_database_name
  - rpc_redis_default_user_name
  - rpc_redis_operation_timeout
  - rpc_request_max_retries
  - rpc_request_retry_waiting_time
  - rpc_request_server_entry_max_retries
  - rpc_request_timeout_delta
  - rpc_server_entry_expire_time
  - rpc_server_net_invalid_time_us
  - rpc_server_net_handler_expire_time
  - rpc_server_net_max_pending_request
  - rpc_srv_session_pool_inactive_timeout
  - rpc_service_mode
  - rpc_support_key_partition_shard_request
  - rpc_sub_request_weight
  - rpc_sub_request_isolation_mode
  - rpc_sub_req_max_retries
  - scan_buffered_rows_warning_threshold
  - 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
  - shard_scan_thread_num
  - short_async_task_timeout
  - skip_proxy_sys_private_check
  - skip_proxyro_check
  - slow_proxy_process_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
  - stack_size
  - stat_dump_interval
  - stat_table_sync_interval
  - syslog_io_bandwidth_limit
  - syslog_level
  - task_thread_num
  - tenant_location_valid_time
  - tunnel_request_size_threshold
  - username_separator
  - work_thread_num
  - xflush_log_level
- 多级配置项
连接管理
数据路由
日志
命令
高可用机制
OBKV
安全和协议
运维
版本发布记录

username_separator

更新时间：2026-04-14 17:41:09

编辑

username_separator 用于设置客户端连接 ODP 时使用的用户名分隔符。

属性	描述
参数类型	字符串列表类型
默认值	`:`；`-`；`.`
取值范围	不涉及
是否重启 ODP 生效	否

通过 ODP 连接 OceanBase 数据库时，用户名的格式需包含集群名、实例名和用户名。格式有如下四种，常用格式为前两种。

用户名@租户名#集群名
集群名:租户名:用户名
集群名-租户名-用户名
集群名.租户名.用户名