云控制台登录 / 注册

免费试用

本地部署

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

schema_history_expire_time | OceanBase 文档中心

文档反馈

分布式版-V3.2.4企业版LTS

V3.2.4 文档更新记录
文档概览
使用指南
- 介绍
- 部署数据库
- 数据迁移
- 数据库连接和路由
- 集群和多租户管理
- 数据库对象管理
- 分布式存储管理
- 性能调优
- 高可用和容灾
- 数据库安全
- 运维操作
- 系统参考
  - 系统配置项
    - 系统配置项概述
    - 系统配置项总览
    - 集群级配置项
      - all_cluster_list
      - auto_broadcast_location_cache_rate_limit
      - auto_delete_expired_backup
      - auto_leader_switch_interval
      - auto_refresh_location_cache_rate_limit
      - autoinc_cache_refresh_interval
      - backup_backup_archive_log_batch_count
      - backup_backup_archivelog_retry_interval
      - backup_backup_dest
      - backup_backupset_batch_count
      - backup_backup_dest_option
      - backup_backupset_retry_interval
      - backup_concurrency
      - backup_dest
      - backup_dest_option
      - 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_idle_time
      - 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_cache_priority
      - clog_disk_usage_limit_percentage
      - clog_disk_utilization_threshold
      - clog_expire_days
      - clog_sync_time_warn_threshold
      - clog_transport_compress_all
      - clog_transport_compress_func
      - cluster
      - cluster_id
      - config_additional_dir
      - cpu_count
      - cpu_quota_concurrency
      - cpu_reserved
      - 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_row_format
      - default_transport_compress_func
      - devname
      - disk_io_thread_count
      - dtl_buffer_size
      - election_blacklist_interval
      - election_cpu_quota
      - enable_async_syslog
      - enable_auto_leader_switch
      - enable_auto_refresh_location_cache
      - enable_ddl
      - enable_election_group
      - enable_global_freeze_trigger
      - enable_log_archive
      - enable_major_freeze
      - enable_manual_merge
      - enable_merge_by_turn
      - enable_ob_ratelimit
      - enable_one_phase_commit
      - enable_perf_event
      - enable_pg
      - enable_rebalance
      - enable_record_trace_id
      - enable_record_trace_log
      - enable_rereplication
      - enable_rich_error_msg
      - enable_rootservice_standalone
      - enable_separate_sys_clog
      - enable_smooth_leader_switch
      - enable_sql_audit
      - enable_sql_operator_dump
      - enable_sys_unit_standalone
      - enable_syslog_recycle
      - enable_syslog_wf
      - enable_tcp_keepalive
      - enable_unit_balance_resource_weight
      - enable_upgrade_mode
      - fast_recovery_concurrency
      - flush_log_at_trx_commit
      - force_refresh_location_cache_interval
      - force_refresh_location_cache_threshold
      - freeze_trigger_percentage
      - fuse_row_cache_priority
      - gc_wait_archive
      - get_leader_candidate_rpc_timeout
      - global_index_build_single_replica_timeout
      - global_major_freeze_residual_memory
      - global_write_halt_residual_memory
      - high_priority_net_thread_count
      - ignore_replay_checksum_error
      - ignore_replica_checksum_error
      - ilog_index_expire_time
      - index_cache_priority
      - index_clog_cache_priority
      - index_info_block_cache_priority
      - internal_sql_execute_timeout
      - large_query_threshold
      - large_query_worker_percentage
      - leak_mod_to_check
      - lease_time
      - location_cache_cpu_quota
      - location_cache_expire_time
      - location_cache_priority
      - 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_archive_concurrency
      - log_restore_concurrency
      - major_compact_trigger
      - major_freeze_duty_time
      - max_kept_major_version_number
      - max_px_worker_count
      - max_string_print_length
      - max_syslog_file_count
      - max_trx_part_count
      - memory_chunk_cache_size
      - memory_limit
      - memory_limit_percentage
      - memory_reserved
      - memstore_limit_percentage
      - merge_stat_sampling_ratio
      - merge_thread_count
      - merger_check_interval
      - 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_compact_trigger
      - minor_deferred_gc_time
      - minor_freeze_times
      - minor_merge_concurrency
      - minor_warm_up_duration_time
      - multiblock_read_gap_size
      - multiblock_read_size
      - mysql_port
      - net_thread_count
      - ob_event_history_recycle_interval
      - ob_ratelimit_stat_period
      - obconfig_url
      - ofs_list
      - partition_table_check_interval
      - partition_table_scan_batch_count
      - plan_cache_evict_interval
      - plan_cache_high_watermark
      - plan_cache_low_watermark
      - px_task_size
      - px_workers_per_cpu_quota
      - rebuild_replica_data_lag_threshold
      - recyclebin_object_expire_time
      - replica_safe_remove_time
      - resource_hard_limit
      - resource_soft_limit
      - restore_concurrency
      - rootservice_async_task_queue_size
      - rootservice_async_task_thread_count
      - rootservice_list
      - rootservice_memory_limit
      - rootservice_ready_check_interval
      - row_compaction_update_limit
      - row_purge_thread_count
      - 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_data_copy_in_concurrency
      - server_data_copy_out_concurrency
      - server_permanent_offline_time
      - server_temporary_offline_time
      - sql_audit_memory_limit
      - sql_audit_queue_size
      - ssl_client_authentication
      - ssl_external_kms_info
      - stack_size
      - switchover_process_thread_count
      - sys_bkgd_io_high_percentage
      - sys_bkgd_io_low_percentage
      - sys_bkgd_migration_change_member_list_timeout
      - sys_bkgd_migration_retry_num
      - sys_bkgd_net_percentage
      - sys_cpu_limit_trigger
      - syslog_io_bandwidth_limit
      - syslog_level
      - system_cpu_quota
      - system_memory
      - system_trace_level
      - tableapi_transport_compress_func
      - tablet_size
      - tcp_keepcnt
      - tcp_keepidle
      - tcp_keepintvl
      - tenant_cpu_variation_per_server
      - tenant_groups
      - tenant_task_queue_size
      - token_reserved_percentage
      - trace_log_sampling_interval
      - trace_log_slow_query_watermark
      - trx_2pc_retry_interval
      - trx_force_kill_threshold
      - trx_try_wait_lock_timeout
      - unit_balance_resource_weight
      - use_large_pages
      - user_block_cache_priority
      - user_iort_up_percentage
      - user_row_cache_priority
      - user_tab_col_stat_cache_priority
      - virtual_table_location_cache_expire_time
      - wait_leader_batch_count
      - weak_read_version_refresh_interval
      - workers_per_cpu_quota
      - zone
      - zone_merge_concurrency
      - zone_merge_order
      - zone_merge_timeout
      - ob_esi_rpc_port
      - enable_ob_esi_process
      - ob_esi_session_timeout
      - ob_esi_io_concurrency
      - ob_esi_memory_limit
      - ob_esi_syslog_level
      - ob_esi_max_syslog_file_count
      - sql_login_thread_count
      - diag_syslog_per_error_limit
      - enable_cgroup
      - rpc_client_authentication_method
      - rpc_server_authentication_method
      - max_trx_part_size
      - max_trx_2pc_retry_interval
    - 租户级配置项
  - 常见隐藏配置项
  - 系统变量（Oracle 模式）
  - 系统变量（MySQL 模式）
  - 系统视图（MySQL 模式）
  - 系统视图（Oracle 模式）
  - 常见统计事件说明
  - 常见等待事件说明
  - 常用内部表
  - 错误码（MySQL 模式）
  - 错误码（Oracle 模式）
  - 预留关键字（MySQL 模式）
  - 预留关键字（Oracle 模式）
开发指南
系统架构
版本发布记录
术语

schema_history_expire_time

更新时间：2026-06-22 11:09:15

功能描述

schema_history_expire_time 可用于设置需要保留的完整元数据历史数据的范围，也可用于设置延迟删除的租户的保留时间。

属性说明

属性	描述
参数类型	时间类型
默认值	30d，d 表示天说明从 V3.2.4 BP1 版本开始，默认值由 7d 调整为 30d。
取值范围	[1m, 365d] 说明从 V3.2.4 BP1 版本开始，取值范围由 [1h, 30d] 调整为 [1m, 365d]。
是否重启 OBServer 生效	否

使用说明

比如当该配置项的值设置为 5d 时，表示最新 5 天内产生的完整元数据历史数据需要被保留，之前的元数据历史数据可以被元数据历史数据回收服务回收。有关元数据历史数据回收服务的详细介绍，请参见 schema_history_recycle_interval。

配置示例

ALTER SYSTEM SET schema_history_expire_time='1d';