云控制台登录 / 注册

免费试用

本地部署

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

enable_kv_ttl - OceanBase 数据库 V4.6.0 | OceanBase 文档中心

文档反馈

分布式版-V4.6.0

What's New
简介
快速上手
应用开发
部署
升级
数据迁移
管理数据库
AP
AI
共享存储
生态集成
实践教程
参考指南
- 系统原理
- 系统管理
- 数据库对象管理
- 数据库设计规范和约束
- SQL 参考
- PL 参考
- 系统视图
- 配置项和系统变量
  - 配置项和系统变量概述
  - V3.x 与 V4.x 配置项和系统变量变更
  - 配置项
    - 配置项总览
    - 集群级别配置项
    - 租户级别配置项
      - arbitration_timeout
      - archive_lag_target
      - approx_count_distinct_precision
      - audit_log_buffer_size
      - audit_log_compression
      - audit_log_enable
      - attach_shared_sstable_thread_score
      - audit_log_format
      - audit_log_max_size
      - audit_log_path
      - audit_log_prune_seconds
      - audit_log_query_sql
      - audit_log_rotate_on_size
      - audit_log_strategy
      - audit_sys_operations
      - audit_trail
      - auto_split_tablet_size
      - backup_data_file_size
      - balancer_idle_time
      - choose_migration_source_policy
      - clog_max_unconfirmed_log_count
      - clog_persistence_compress_func
      - compaction_dag_cnt_limit
      - compaction_high_thread_score
      - compaction_low_thread_score
      - compaction_mid_thread_score
      - compaction_schedule_tablet_batch_cnt
      - compatible
      - connection_control_failed_connections_threshold
      - connection_control_max_connection_delay
      - connection_control_min_connection_delay
      - cpu_quota_concurrency
      - ddl_thread_score
      - default_auto_increment_mode
      - default_delta_format
      - default_enable_extended_rowid
      - default_load_mode
      - default_micro_block_format_version
      - default_progressive_merge_num
      - default_skip_index_level
      - default_storage_cache_policy
      - default_table_merge_engine
      - default_table_organization
      - default_table_store_format
      - direct_load_allow_fallback
      - ddl_high_thread_score
      - document_ai_file_max_size
      - dump_data_dictionary_to_log_interval
      - enable_adaptive_plan_cache
      - enable_auto_split
      - enable_clog_persistence_compress
      - enable_database_sharding_none
      - enable_early_lock_release
      - enable_hbase_rowkey_ttl
      - enable_pl_rich_error_msg
      - enable_kv_group_commit
      - enable_gts_standalone
      - enable_kv_ttl
      - enable_lock_priority
      - enable_manual_storage_cache_policy
      - enable_mlog_auto_maintenance
      - enable_monotonic_weak_read
      - enable_mv_binlog_minimal_mode
      - enable_ls_leader_balance
      - enable_rebalance
      - enable_sql_extension
      - enable_transfer
      - enable_ttl
      - enable_user_defined_rewrite_rules
      - enable_window_compaction
      - enable_ps_parameterize
      - external_kms_info
      - external_table_io_hole_size
      - external_table_io_range_size
      - external_table_csv_max_buffer_size
      - ob_vector_search_strategy
      - freeze_trigger_percentage
      - global_index_auto_split_policy
      - ha_high_thread_score
      - ha_low_thread_score
      - ha_mid_thread_score
      - inc_sstable_upload_thread_score
      - io_category_config
      - job_queue_processes
      - json_document_max_depth
      - kv_ttl_duty_duration
      - kv_group_commit_batch_size
      - kv_group_commit_rw_mode
      - kv_hbase_client_scanner_timeout_period
      - kv_ttl_delete_max_ops
      - kv_ttl_history_recycle_interval
      - kv_transport_compress_threshold
      - load_data_diagnosis_log_compression
      - load_data_diagnosis_log_max_size
      - load_vector_index_on_follower
      - lob_enable_block_cache_threshold
      - log_archive_concurrency
      - log_disk_throttling_maximum_duration
      - log_disk_throttling_percentage
      - log_disk_utilization_limit_threshold
      - log_disk_utilization_threshold
      - log_restore_concurrency
      - log_storage_compress_all
      - log_storage_compress_func
      - log_transport_compress_all
      - log_transport_compress_func
      - ls_gc_delay_time
      - ls_scale_out_factor
      - major_compact_trigger
      - major_freeze_duty_time
      - max_partition_num
      - max_stale_time_for_weak_consistency
      - mds_compaction_high_thread_score
      - mds_compaction_mid_thread_score
      - mds_minor_compact_trigger
      - merger_check_interval
      - minor_compact_trigger
      - model_max_retries
      - mlog_trim_interval
      - model_request_timeout
      - ob_compaction_schedule_interval
      - ob_enable_batched_multi_statement
      - ob_encoding_granularity
      - ob_enable_java_udf
      - ob_enable_python_udf
      - ob_proxy_readonly_transaction_routing_policy
      - ob_query_switch_leader_retry_timeout
      - ob_ssl_invited_common_names
      - ob_vector_index_active_segment_max_size
      - ob_vector_index_merge_trigger_percentage
      - ob_vector_memory_limit_percentage
      - open_cursors
      - optimizer_index_cost_adj
      - partition_balance_schedule_interval
      - plsql_code_type
      - plsql_debug
      - plsql_optimize_level
      - plsql_v2_compatibility
      - px_node_policy
      - px_target_high_watermark
      - package_state_sync_max_size
      - px_target_low_watermark
      - px_target_workers_per_cpu
      - px_workers_per_cpu_quota
      - query_memory_limit_percentage
      - query_response_time_flush
      - query_response_time_range_base
      - query_response_time_stats
      - range_optimizer_max_mem_size
      - recover_table_concurrency
      - recover_table_dop
      - replica_parallel_migration_mode
      - result_cache_max_size
      - result_cache_max_result
      - rest_oauth2_credential_refresh_interval
      - rest_oauth2_credential_evict_time
      - ob_result_cache_evict_percentage
      - ob_deterministic_udf_cache_max_size
      - rpc_memory_limit_percentage
      - shared_log_retention
      - spill_compression_codec
      - sql_func_extension_mode
      - sql_work_area
      - standby_db_fetch_log_rpc_timeout
      - standby_db_preferred_upstream_log_region
      - sts_credential
      - storage_cache_clean_macro_interval
      - tde_method
      - tenant_sql_login_thread_count
      - tenant_sql_net_thread_count
      - temporary_file_max_disk_size
      - storage_rowsets_size
      - suspend_storage_cache_task
      - ttl_duty_time
      - ttl_thread_score
      - undo_retention
      - vector_index_memory_saving_mode
      - vector_index_optimization_concurrency
      - vector_index_optimize_duty_time
      - workarea_size_policy
      - writing_throttling_maximum_duration
      - writing_throttling_trigger_percentage
      - zone_deploy_mode
  - 系统变量
- 错误码
- 性能调优
- 数据库代理
- 驱动
- 平台产品
- 组件 & 工具
- 数据库插件
常见问题
版本发布记录
术语

enable_kv_ttl

更新时间：2026-06-23 09:59:44

编辑

说明

该配置项从 V3.1.4 版本开始引入。

功能描述

enable_kv_ttl 用于控制是否启动 TTL 后台任务，该配置项对周期性 TTL 任务有效，用户管控命令不受此配置项限制。

注意

过期数据删除（TTL）功能仅限于 OceanBase KV 场景使用，SQL 场景下禁用，否则会导致不可预期的数据误删除问题。

权限要求

查询配置项

sys 租户和所有用户租户均可以使用 SHOW PARAMETERS 语句或视图 GV$OB_PARAMETERS 查询该配置项。
修改配置项

sys 租户和用户租户均可修改该配置项。

属性说明

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

配置示例

设置不启动 TTL 后台任务。

obclient> ALTER SYSTEM SET enable_kv_ttl= false;