云控制台登录 / 注册

免费试用

本地部署

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余套系统国产数据库升级

VIVO

替换 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
日本站 - 日本語

enable_smooth_leader_switch - OceanBase 数据库 V4.2.1 | OceanBase 文档中心

文档反馈

分布式版-V4.2.1LTS

V4.2.1 文档更新记录
简介
快速上手
应用开发
部署数据库
数据迁移
管理数据库
参考指南
- 系统原理
- 系统管理
- 数据库对象管理
- 数据库设计规范和约束
- SQL 参考
- 系统视图
- 配置项和系统变量
  - 配置项和系统变量概述
  - 配置项
    - 配置项总览
    - 集群级别配置项
      - all_cluster_list
      - all_server_list
      - arbitration_degradation_policy
      - auto_broadcast_location_cache_rate_limit
      - auto_leader_switch_interval
      - auto_refresh_location_cache_rate_limit
      - autoinc_cache_refresh_interval
      - backup_backup_dest
      - backup_backup_dest_option
      - backup_dest_option
      - backup_concurrency
      - backup_dest
      - backup_log_archive_option
      - backup_net_limit
      - backup_recovery_window
      - backup_region
      - backup_zone
      - balance_blacklist_failure_threshold
      - balance_blacklist_retry_interval
      - balancer_emergency_percentage
      - balancer_log_interval
      - balancer_task_timeout
      - balancer_timeout_check_interval
      - balancer_tolerance_percentage
      - bf_cache_miss_count_threshold
      - bf_cache_priority
      - builtin_db_data_verify_cycle
      - cache_wash_threshold
      - clog_disk_utilization_threshold
      - clog_expire_days
      - clog_cache_priority
      - clog_disk_usage_limit_percentage
      - clog_sync_time_warn_threshold
      - clog_transport_compress_func
      - cpu_reserved
      - cluster
      - cluster_id
      - config_additional_dir
      - cpu_count
      - data_copy_concurrency
      - data_dir
      - data_disk_usage_limit_percentage
      - data_storage_error_tolerance_time
      - data_storage_warning_tolerance_time
      - datafile_disk_percentage
      - datafile_size
      - dead_socket_detection_timeout
      - debug_sync_timeout
      - default_compress
      - default_compress_func
      - default_transport_compress_func
      - default_row_format
      - devname
      - disk_io_thread_count
      - dtl_buffer_size
      - election_cpu_quota
      - election_blacklist_interval
      - enable_async_syslog
      - enable_auto_refresh_location_cache
      - enable_auto_leader_switch
      - enable_ddl
      - enable_global_background_resource_isolation
      - enable_global_freeze_trigger
      - enable_log_archive
      - enable_election_group
      - enable_major_freeze
      - enable_merge_by_turn
      - enable_manual_merge
      - enable_ob_ratelimit
      - enable_one_phase_commit
      - enable_perf_event
      - enable_pg
      - enable_record_trace_id
      - enable_record_trace_log
      - enable_rereplication
      - enable_rich_error_msg
      - enable_separate_sys_clog
      - enable_smooth_leader_switch
      - enable_rootservice_standalone
      - enable_sql_audit
      - enable_sql_operator_dump
      - enable_sys_table_ddl
      - enable_sys_unit_standalone
      - enable_syslog_recycle
      - enable_syslog_wf
      - enable_tcp_keepalive
      - fast_recovery_concurrency
      - enable_upgrade_mode
      - flush_log_at_trx_commit
      - gc_wait_archive
      - fuse_row_cache_priority
      - global_background_cpu_quota
      - global_index_build_single_replica_timeout
      - global_major_freeze_residual_memory
      - get_leader_candidate_rpc_timeout
      - global_write_halt_residual_memory
      - high_priority_net_thread_count
      - ignore_replay_checksum_error
      - ignore_replica_checksum_error
      - index_clog_cache_priority
      - index_info_block_cache_priority
      - index_cache_priority
      - ilog_index_expire_time
      - internal_sql_execute_timeout
      - large_query_threshold
      - large_query_worker_percentage
      - leak_mod_to_check
      - lease_time
      - location_cache_cpu_quota
      - location_cache_priority
      - location_cache_expire_time
      - location_cache_refresh_min_interval
      - location_cache_refresh_rpc_timeout
      - location_cache_refresh_sql_timeout
      - location_fetch_concurrency
      - location_refresh_thread_count
      - log_archive_batch_buffer_limit
      - log_archive_checkpoint_interval
      - log_storage_warning_trigger_percentage
      - max_kept_major_version_number
      - max_px_worker_count
      - max_string_print_length
      - max_syslog_file_count
      - memory_chunk_cache_size
      - memory_limit
      - memory_limit_percentage
      - memory_reserved
      - memstore_limit_percentage
      - merge_stat_sampling_ratio
      - merge_thread_count
      - merger_completion_percentage
      - merger_switch_leader_duration_time
      - merger_warm_up_duration_time
      - micro_block_merge_verify_level
      - migrate_concurrency
      - migration_disable_time
      - min_observer_version
      - minor_deferred_gc_time
      - mysql_port
      - net_thread_count
      - ob_event_history_recycle_interval
      - ob_ratelimit_stat_period
      - obconfig_url
      - tablet_meta_table_check_interval
      - tablet_meta_table_scan_batch_count
      - plan_cache_evict_interval
      - plan_cache_high_watermark
      - plan_cache_low_watermark
      - px_task_size
      - px_workers_per_cpu_quota
      - rdma_io_thread_count
      - recyclebin_object_expire_time
      - ls_meta_table_check_interval
      - resource_hard_limit
      - rebuild_replica_data_lag_threshold
      - rootservice_async_task_queue_size
      - rootservice_async_task_thread_count
      - rootservice_list
      - rootservice_memory_limit
      - rootservice_ready_check_interval
      - row_compaction_update_limit
      - rpc_port
      - rpc_timeout
      - schema_history_expire_time
      - schema_history_recycle_interval
      - server_balance_cpu_mem_tolerance_percent
      - server_balance_critical_disk_waterlevel
      - server_balance_disk_tolerance_percent
      - server_check_interval
      - server_cpu_quota_max
      - server_cpu_quota_min
      - server_permanent_offline_time
      - server_data_copy_out_concurrency
      - server_data_copy_in_concurrency
      - ssl_client_authentication
      - ssl_external_kms_info
      - stack_size
      - sql_audit_memory_limit
      - sys_bkgd_migration_change_member_list_timeout
      - sys_bkgd_migration_retry_num
      - sys_bkgd_net_percentage
      - switchover_process_thread_count
      - syslog_io_bandwidth_limit
      - sys_bkgd_io_high_percentage
      - syslog_level
      - sys_bkgd_io_low_percentage
      - sys_cpu_limit_trigger
      - system_memory
      - system_trace_level
      - tableapi_transport_compress_func
      - tablet_size
      - tcp_keepcnt
      - system_cpu_quota
      - tcp_keepidle
      - tcp_keepintvl
      - tenant_cpu_variation_per_server
      - tenant_task_queue_size
      - token_reserved_percentage
      - trace_log_sampling_interval
      - trace_log_slow_query_watermark
      - trx_2pc_retry_interval
      - tenant_groups
      - use_large_pages
      - user_block_cache_priority
      - trx_force_kill_threshold
      - user_row_cache_priority
      - trx_try_wait_lock_timeout
      - unit_balance_resource_weight
      - virtual_table_location_cache_expire_time
      - weak_read_version_refresh_interval
      - user_iort_up_percentage
      - workers_per_cpu_quota
      - zone
      - user_tab_col_stat_cache_priority
      - wait_leader_batch_count
      - log_disk_size
      - log_disk_percentage
      - tablet_ls_cache_priority
      - opt_tab_stat_cache_priority
      - zone_merge_concurrency
      - index_block_cache_priority
      - zone_merge_order
      - sql_login_thread_count
      - zone_merge_timeout
      - enable_asan_for_memory_context
      - ob_esi_rpc_port
      - enable_cgroup
      - enable_ob_esi_process
      - diag_syslog_per_error_limit
      - ob_esi_session_timeout
      - ob_esi_io_concurrency
      - ob_startup_mode
      - ob_esi_memory_limit
      - log_storage_warning_tolerance_time
      - ob_esi_syslog_level
      - ob_esi_max_syslog_file_count
      - sql_net_thread_count
      - minor_freeze_times
      - minor_merge_concurrency
      - minor_warm_up_duration_time
      - multiblock_read_gap_size
      - multiblock_read_size
      - ofs_list
      - partition_table_check_interval
      - replica_safe_remove_time
      - resource_soft_limit
      - restore_concurrency
      - rpc_client_authentication_method
      - rpc_server_authentication_method
      - row_purge_thread_count
      - datafile_maxsize
      - datafile_next
      - standby_fetch_log_bandwidth_limit
      - local_ip
      - observer_id
      - storage_meta_cache_priority
      - sql_protocol_min_tls_version
      - enable_dblink
      - ob_storage_s3_url_encode_type
    - 租户级别配置项
  - 系统变量
- 错误码
- 性能调优
- 性能测试
- 数据库代理
- 驱动
- 平台产品
- 组件 & 工具
常见问题
版本发布记录
术语

enable_smooth_leader_switch

更新时间：2026-04-16 00:11:37

编辑

说明

由于 V4.x 版本不再支持分区 Leader 切换，该配置项从 V4.0.0 版本开始删除。

功能描述

enable_smooth_leader_switch 是平滑切主特性（主动切换分区 Leader）的开关。

属性说明

属性	描述
参数类型	Bool
默认值	True
取值范围	True 或 1 False 或 0
是否可修改	是，支持通过 `ALTER SYSTEM SET` 语句修改。
是否重启 OBServer 节点生效	否，设置后立即生效。

配置示例

开启分区平滑切主功能。

obclient> ALTER SYSTEM SET enable_smooth_leader_switch = True;

或者

obclient> ALTER SYSTEM SET enable_smooth_leader_switch = 1;