---
title: "V3.x 与 V4.x 配置项和系统变量变更 - OceanBase 数据库 V4.3.4 | OceanBase 文档中心"
description: V3.x 与 V4.x 配置项和系统变量变更 由于 OceanBase 数据库在 V4.x 版本进行了架构的变更升级以及重构调整，很多配置项或变量已不再起作用，V4.x 对于无效的配置项或变量进行了删除和变更。例如，用于触发 Major Freeze 的配置项 minor_freeze_times 已经删除。同时，我…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.4

# V3.x 与 V4.x 配置项和系统变量变更

更新时间：2025-01-24 17:02:59

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.4/zh-CN/700.reference/800.configuration-items-and-system-variables/020.changes-in-configuration-items-and-variables-for-v3-and-v4.md)  

由于 OceanBase 数据库在 V4.x 版本进行了架构的变更升级以及重构调整，很多配置项或变量已不再起作用，V4.x 对于无效的配置项或变量进行了删除和变更。例如，用于触发 Major Freeze 的配置项 `minor_freeze_times` 已经删除。同时，我们还调整了一些配置项的默认值，例如，V4.x 版本从底层解决了大事务能力的支持，事务不再受冻结操作的影响，故将 `freeze_trigger_percentage` 的默认值调整为 20%。

## V4.x 版本中配置项相关的变更

### 替换的配置项

下表中列出了 V4.x 版本中用于替换 V3.x 版本的配置项。

| 配置项名（V3.x） | 替换后的配置项名（V4.x） | 描述 |
| --- | --- | --- |
| [backup_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576380) | [ha_low_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576200) | 替换后的配置项为租户级别 |
| [clog_disk_utilization_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576346) | [log_disk_utilization_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576193) | 替换后的配置项为租户级别 |
| [clog_transport_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576474) | [log_transport_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576160) | 替换后的配置项为租户级别 |
| [data_copy_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576280)、[fast_recovery_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576334)、[restore_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576267) | [ha_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576191) | 替换后的配置项为租户级别 |
| [log_archive_checkpoint_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576272) | [archive_lag_target](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576137) | 替换后的配置项为租户级别 |
| [merge_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576448) | [compaction_low_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576139) | 替换后的配置项为租户级别 |
| [migrate_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576277) 、[server_data_copy_out_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576405)、[server_data_copy_in_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576317) | [ha_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576192) | 替换后的配置项为租户级别 |
| [sql_audit_memory_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576449) | [ob_sql_audit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576522) | 替换为租户变量，不再是配置项 |
| [minor_merge_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576383) | [compaction_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576149) | 替换后的配置项为租户级别 |
| [clog_persistence_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576214) | [log_storage_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576208) | 替换后的配置项为租户级别 |
| [enable_clog_persistence_compress](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576157) | [log_storage_compress_all](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576212) | 替换后的配置项为租户级别 |

### 更改名称的配置项

下表列出了在 V4.x 版本中更改了名称的配置项。

| 配置项名（V3.x） | 配置项名（V4.x） | 描述 |
| --- | --- | --- |
| tableapi_transport_compress_func | kv_transport_compress_func | - 对于 V4.2.x 版本，从 V4.2.1 BP2 版本开始更名，同时级别调整为租户级别。 - 对于 V4.3.x 版本，从 V4.3.4 版本开始更名，同时级别调整为租户级别。 |

### 更改生效范围的配置项

OceanBase 数据库是多租户架构，大多数用户会选择在同一个集群中创建多个租户，再根据业务种类的不同来分别进行管理。为了满足用户一个租户代表一个业务单元的使用需求，在 V4.x 版本中，将集群级别的能力拆分为租户级别，例如，租户级的备份，租户级的转储与合并。

下表列出了更改生效范围的配置项。

| 配置项名 | 描述 |
| --- | --- |
| [backup_data_file_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576188) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，由集群级变更为租户级。 - 对于 V4.2.x 版本，从 V4.2.1 BP2 版本开始，由集群级变更为租户级。 |
| [enable_rebalance](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576203) | 从 V4.2.0 版本开始，由集群级变更为租户级。 |
| [balancer_idle_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576220) | 从 V4.2.0 版本开始，由集群级变更为租户级。 |
| [log_archive_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576210) | 从 V4.1.0 版本开始，由集群级变更为租户级。 |
| [log_restore_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576206) | 从 V4.1.0 版本开始，由集群级变更为租户级。 |
| [major_compact_trigger](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576202) | 从 V4.0.0 版本开始，由集群级变更为租户级。 |
| [minor_compact_trigger](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576150) | 从 V4.0.0 版本开始，由集群级变更为租户级。 |

### 更改生效模式的配置项

配置项一般分为动态生效和重启生效等两种生效模式，大部分配置项为动态生效方式，即不需要重启 OBServer 节点就可以生效。

下表列出了更改生效模式的配置项。

| 配置项名 | 描述 |
| --- | --- |
| [server_cpu_quota_min](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576337) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，生效模式由重启生效变更为立即生效。 - 对于 V4.2.x 版本，暂未更改生效模式。 |
| [server_cpu_quota_max](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576278) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，生效模式由重启生效变更为立即生效。 - 对于 V4.2.x 版本，暂未更改生效模式。 |

### 更改默认值的配置项

下表中列出了更改默认值的配置项。

| 配置项名 | 描述 |
| --- | --- |
| [memstore_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576225) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，默认值由 50 调整为 0。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始，默认值由 50 调整为 0。 |
| [range_optimizer_max_mem_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576174) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，默认值由 128 M 调整为 0M。 - 对于 V4.2.x 版本，从 V4.2.2 版本开始，默认值由 128 M 调整为 0M。 |
| [ls_gc_delay_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576177) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，默认值由 1h 调整为 0s。 - 对于 V4.2.x 版本，从 V4.2.1 BP1 版本开始，默认值由 1h 调整为 0s。 |
| [enable_monotonic_weak_read](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576207) | 从 V4.2.1 版本开始，默认值由 true 调整为 false。 |
| [location_refresh_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576394) | 从 V4.2.0 版本开始，默认值由 4 调整为 2。 |
| [enable_record_trace_id](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576343) | 从 V4.2.0 版本开始，默认值由 true 调整为 false。 |
| [plan_cache_evict_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576465) | 从 V4.2.0 版本开始，默认值由 1s 调整为 5s。 |
| [tenant_task_queue_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576261) | 从 V4.1.0 版本开始，默认值由 65536 调整为 16384。 |
| [server_cpu_quota_min](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576337) | - 从 V4.2.1 版本开始，默认值由 1 调整为 0。 - 从 V4.0.0 版本开始，默认值由 2.5 调整为 1。 |
| [writing_throttling_maximum_duration](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576135) | 从 V4.0.0 版本开始，默认值由 1h 调整为 2h。 |
| [writing_throttling_trigger_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576186) | 从 V4.0.0 版本开始，默认值由 100 调整为 60。 |
| [freeze_trigger_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576215) | 从 V4.0.0 版本开始，默认值由 70 调整为 20。 |

### 更改取值范围的配置项

下表中列出了更改取值范围的配置项。

| 配置项名 | 描述 |
| --- | --- |
| [ob_startup_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576279) | 从 V4.3.4 版本开始，取值范围中增加 `SHARED_STORAGE` 的取值。 |
| [large_query_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576249) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，取值范围由 [1ms, +∞) 变更为 [0ms, +∞)。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始，取值范围由 [1ms, +∞) 变更为 [0ms, +∞)。 |
| [memstore_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576225) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，取值范围由 (0, 100) 调整为 [0, 100)。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始，取值范围由 (0, 100) 调整为 [0, 100)。 |
| [range_optimizer_max_mem_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576174) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，取值范围由 [16M，1G] 调整为 [0M，+∞)。 - 对于 V4.2.x 版本，从 V4.2.2 版本开始，取值范围由 [16M，1G] 调整为 [0M，+∞)。 |
| [job_queue_processes](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576164) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，取值范围由 [0,1000] 调整为 [0,16384]。 - 对于 V4.2.x 版本，从 V4.2.1 BP1 版本开始，取值范围由 [0,1000] 调整为 [0,16384]。 |
| [memory_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576393) | 从 V4.2.1 版本开始，取值范围由 [10, 90] 调整为 [10, 95]。 |
| [cpu_quota_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576161) | 从 V4.2.0 版本开始，取值范围由 [1,10] 调整为 [1,20]。 |
| [memory_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576430) | 从 V4.1.0 版本开始，取值范围由 [4G, +∞) 调整为 [1G, +∞)。 |
| [server_cpu_quota_min](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576337) | - 从 V4.2.1 版本开始，取值范围由 [1，16] 调整为 [0, 16]。 - 从 V4.0.0 版本开始，取值范围由 [0，16] 调整为 [1, 16]。 |

### 更改语义的配置项

下表中列出了在 V4.x 版本中更改了语义的配置项。

| 配置项名 | 描述 |
| --- | --- |
| [datafile_maxsize](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576457) | 从 V4.3.4 版本开始，无共享（Shared-Nothing，SN）模式下，该配置项语义不变；共享存储（Shared-Storage，SS）模式下，该配置项无意义。 |
| [datafile_next](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576331) | 从 V4.3.4 版本开始，无共享（Shared-Nothing，SN）模式下，该配置项语义不变；共享存储（Shared-Storage，SS）模式下，该配置项无意义。 |
| [datafile_disk_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576341) | 从 V4.3.4 版本开始，无共享（Shared-Nothing，SN）模式下，该配置项语义不变；共享存储（Shared-Storage，SS）模式下，该配置项用于设置本地可用缓存空间占磁盘总空间的百分比。 |
| [datafile_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576331) | 从 V4.3.4 版本开始，无共享（Shared-Nothing，SN）模式下，该配置项语义不变；共享存储（Shared-Storage，SS）模式下，该配置项用于设置本地缓存空间的大小。 |

### 新增的配置项

下表中列出了在 V4.x 版本中新增的配置项。

| 配置项名 | 引入版本 | 描述 |
| --- | --- | --- |
| [arbitration_degradation_policy](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001625249) | V4.3.4 | 用于设置自动降级的策略。 |
| [kv_hbase_client_scanner_timeout_period](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001581629) | V4.3.4 | 设置 OBKV-HBase 流式查询的超时时间。 |
| default_load_mode | V4.3.4 | 控制当导数操作没有指定 Hint 时，使用配置项定义的 Hint。 |
| direct_load_allow_fallback | V4.3.4 | 控制当导数操作场景旁路导入不支持时，是否报错。 |
| [enable_auto_split](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001623041) | V4.3.4 | 控制该表是否需要开启自动分区功能。 |
| [auto_split_tablet_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001623042) | V4.3.4 | 控制租户开启自动分区功能之后触发分裂的阈值。 |
| [sync_io_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001605561) | V4.3.4 | 配置同步 IO 请求的线程数。 |
| [ob_encoding_granularity](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001603516) | V4.3.3 | 用于控制向量索引模块能使用内存资源的上限百分比。 |
| [ob_storage_s3_url_encode_type](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576468) | V4.3.3 | 设置 S3 发送请求时的 URL 编码方式是否兼容 Rfc3986 标准。 |
| [ob_vector_memory_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576196) | V4.3.3 | 配置向量索引模块对内存资源占用的阈值（单位为百分比）。 |
| [storage_rowsets_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576187) | V4.3.2 | 控制列存引擎一次向量化批处理行数。 |
| [alert_log_level](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576271) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 设置警告日志的级别。 |
| [enable_global_background_resource_isolation](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576463) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 控制是否开启全局前后台资源隔离功能。 |
| [global_background_cpu_quota](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576289) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 控制在开启全局前后台资源隔离时后台任务的 CPU 核数。 |
| [choose_migration_source_policy](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576154) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始引入。 - 对于 V4.2.1 版本，从 V4.2.1 BP7 版本开始引入；对于 V4.2.x 其他版本，从 V4.2.3 版本开始引入。 | 指定迁移选择源端副本的优先策略。 |
| [lob_enable_block_cache_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576134) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 设置 OUTROW 存储的 LOB 查询缓存的阈值。 |
| [spill_compression_codec](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576178) | V4.3.1 | 指定压缩算法类型以实现 SQL 执行过程中的数据落盘压缩。 |
| [max_partition_num](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576165) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.1 BP3 版本开始引入。 | 控制 MySQL 模式下允许的最大分区数。 |
| [log_storage_compress_all](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576212) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.2 版本开始引入。 | 控制是否开启 clog 存储压缩功能。 |
| [syslog_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576260) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 设置系统日志的压缩算法。 |
| [syslog_disk_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576425) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 设置系统日志的磁盘空间上限。 |
| [syslog_file_uncompressed_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576322) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 设置系统日志不压缩的文件数量。 |
| [log_storage_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576208) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.2 版本开始引入。 | 设置 clog 存储压缩的压缩算法。 |
| [enable_dblink](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576345) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.1 BP4 版本开始引入。 | 控制是否开启 DBLink 功能。 |
| [data_disk_write_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576315) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 控制数据盘写入的限制百分比。 |
| [strict_check_os_params](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576417) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.2 版本开始引入。 | 控制是否开启检查 OS 配置参数的功能开关。 |
| [default_table_store_format](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576175) | V4.3.0 | 指定用户租户默认创建表的格式，包括行存、纯列存和冗余行存列存。 |
| [enable_rpc_authentication_bypass](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576306) | V4.3.0 | 在 OBServer 集群开启 RPC 安全认证的场景下，设置是否允许 OMS 迁移服务以及 OBKV 服务绕过 RPC 安全认证连接到集群。 |
| [sql_protocol_min_tls_version](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576439) | V4.2.1 | 设置 SQL 语句进行 SSL 连接时所使用的 SSL/TLS 协议的最低版本号。 |
| [compaction_dag_cnt_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576132) | V4.2.1 | 配置 Compaction DAG 队列上 DAG 数量的上限值。 |
| [compaction_schedule_tablet_batch_cnt](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576142) | V4.2.1 | 配置 Compaction 分批调度时，每个批次调度的分区数的上限值。 |
| [enable_transfer](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576213) | V4.2.1 | 控制是否允许在租户内进行 Transfer。 |
| [ttl_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576156) | V4.2.1 | 设置 TTL 任务使用线程时间片的权重值。 |
| [local_ip](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576336) | V4.2.0 | 部署集群时指定的安装 ObServer 机器的 IP 地址。 |
| [observer_id](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576453) | V4.2.0 | 集群中 RS 分配给 OBServer 节点的唯一标识。 |
| [standby_fetch_log_bandwidth_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576229) | V4.2.0 | 设置备租户所在集群中的所有 Server 从主租户同步日志的流量总和每秒可占用的最大带宽。 |
| [storage_meta_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576309) | V4.2.0 | 控制 kvcache 中存储 Meta Cache 的优先级。 |
| [archive_lag_target](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576137) | V4.2.0 | 控制租户日志归档延迟的时间。 |
| [log_disk_throttling_maximum_duration](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576153) | V4.2.0 | 调整触发日志限速后，日志盘的最大可用时间。 |
| [log_disk_throttling_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576169) | V4.2.0 | 触发日志写入限速的不可回收日志盘空间占比。 |
| [ls_gc_delay_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576177) | V4.2.0 | 配置租户日志流延迟删除的时间。 |
| [partition_balance_schedule_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576190) | V4.2.0 | 设置分区均衡调度周期。 |
| [range_optimizer_max_mem_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576174) | V4.2.0 | 限制 Query Range 模块使用的内存。 |
| [standby_db_fetch_log_rpc_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576151) | V4.2.0 | 设置备库拉取日志 RPC 超时时间，以控制备库日志传输服务检测主库某台 Server 不可用并切换到其他 Server。 |
| [standby_db_preferred_upstream_log_region](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576166) | V4.1.0 | 配置物理备库场景下，备租户同步上游日志的首选 Region。 |
| [log_storage_warning_tolerance_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576301) | V4.1.0 | 设置从日志盘 IO 失败到磁盘被标记为坏盘时触发切主的时间。 |
| [ob_startup_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576279) | V4.1.0 | 设置 OBServer 节点的启动模式，仅支持在第一次启动时修改。 |
| [sql_net_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576476) | V4.1.0 | 设置 MySQL 集群 IO 线程的个数，即 `global_sql_nio_server` 线程的个数。 |
| [arbitration_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576176) | V4.1.0 | 设置触发自动降级的超时时间。 |
| [dump_data_dictionary_to_log_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576185) | V4.1.0 | 控制租户数据字典持久化的周期。 |
| [enable_user_defined_rewrite_rules](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576152) | V4.1.0 | 控制用户自定义规则是否开启的开关。 |
| [log_transport_compress_all](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576136) | V4.1.0 | 对日志传输是否使用压缩。 |
| [log_transport_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576160) | V4.1.0 | 指定日志传输的压缩算法。 |
| [rpc_memory_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576170) | V4.1.0 | 设置租户中 RPC 的最大内存占租户总内存的百分比。 |
| [tenant_sql_login_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576195) | V4.1.0 | 设置 MySQL 租户登录的线程个数，即 `mysql_queue` 线程的个数。 |
| [tenant_sql_net_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576182) | V4.1.0 | MySQL 租户 IO 线程的个数，即 `sql_nio_server` 线程的个数。 |
| [log_disk_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576237) | V4.0.0 | 设置 Redo 日志占用其所在磁盘总空间的百分比。 |
| [log_disk_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576377) | V4.0.0 | 设置 Redo 日志磁盘的大小，即本 OBServer 可以使用的日志盘总空间大小。 |
| [ha_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576191) | V4.0.0 | 设置高可用高优先级线程的当前工作线程数。 |
| [ha_low_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576200) | V4.0.0 | 设置高可用低优先级线程的当前工作线程数。 |
| [ha_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576192) | V4.0.0 | 设置高可用中优先级线程的当前工作线程数。 |

### 废弃的配置项

下表中列出了在 V4.x 版本中被废弃的配置项。

| 配置项名 | 描述 |
| --- | --- |
| [global_write_halt_residual_memory](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576462) | 相关功能不再使用，从 V4.2.0 版本开始删除。 |
| [max_px_worker_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576241) | 相关功能不再使用，从 V4.2.0 版本开始删除。 |
| [plan_cache_high_watermark](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576401) | 相关功能一直未支持，从 V4.2.0 版本开始删除。 |
| [plan_cache_low_watermark](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576342) | 相关功能一直未支持，从 V4.2.0 版本开始删除。 |
| [rootservice_memory_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576398) | 架构升级变更，从 V4.2.0 版本开始删除。 |
| [system_trace_level](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576269) | 实现逻辑变更，该配置项已不适用，从 V4.2.0 版本开始删除。 |
| [token_reserved_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576353) | 实现逻辑变更，该配置项已不适用，从 V4.2.0 版本开始删除。 |
| [trace_log_sampling_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576284) | 实现逻辑变更，该配置项已不适用，从 V4.2.0 版本开始删除。 |
| [io_category_config](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576173) | 实现逻辑变更，该配置项已不适用，从 V4.2.0 版本开始删除。 |
| [auto_broadcast_location_cache_rate_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576441) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [auto_leader_switch_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576440) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [auto_refresh_location_cache_rate_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576391) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [backup_backup_dest](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576389) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [backup_backup_dest_option](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576470) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [backup_dest_option](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576283) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [backup_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576380) | 架构升级变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [ha_low_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576200) 替代该配置项。 |
| [backup_dest](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576286) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [backup_log_archive_option](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576273) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [backup_net_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576364) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [backup_recovery_window](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576370) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [backup_region](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576416) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [backup_zone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576421) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [balance_blacklist_failure_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576236) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [balance_blacklist_retry_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576460) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [balancer_emergency_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576443) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [balancer_timeout_check_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576361) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [clog_disk_utilization_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576346) | 架构升级变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [log_disk_utilization_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576193) 替代该配置项。 |
| [clog_expire_days](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576351) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [clog_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576365) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [clog_disk_usage_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576434) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [clog_transport_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576474) | V4.0.0 版本暂未支持该功能，从 V4.0.0 版本开始删除。从 V4.1.0 版本开始新增配置项 [log_transport_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576160) 替代该配置项。 |
| [clog_max_unconfirmed_log_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576216) | 实现逻辑变更，相关功能不再适用，从 V4.0.0 版本开始删除。 |
| [clog_persistence_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576214) | 相关功能在 V4.0.0 版本未支持，从 V4.0.0 版本开始删除。从 V4.2.1 版本开始（不含 V4.3.0 版本）重新支持，新增 [log_storage_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576208) 替代该配置项。 |
| [cpu_reserved](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576371) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [data_copy_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576280) | 实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [ha_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576191) 替代该配置项。 |
| [default_transport_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576414) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [election_cpu_quota](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576392) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [election_blacklist_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576256) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [enable_auto_refresh_location_cache](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576415) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [enable_auto_leader_switch](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576467) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [enable_clog_persistence_compress](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576157) | 相关功能在 V4.0.0 版本未支持，从 V4.0.0 版本开始删除。从 V4.2.1 版本开始（不含 V4.3.0 版本）重新支持，新增 [log_storage_compress_all](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576212) 替代该配置项。 |
| [enable_global_freeze_trigger](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576358) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [enable_log_archive](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576388) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [enable_election_group](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576422) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [enable_merge_by_turn](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576232) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [enable_manual_merge](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576262) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [enable_one_phase_commit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576338) | 实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。 |
| [enable_pg](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576230) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [enable_separate_sys_clog](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576243) | 相关功能一直未生效，从 V4.0.0 版本开始删除。 |
| [enable_smooth_leader_switch](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576323) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [enable_rootservice_standalone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576386) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [fast_recovery_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576334) | 实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [ha_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576191) 替代该配置项。 |
| [flush_log_at_trx_commit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576314) | 使用率较低，从 V4.0.0 版本开始删除。 |
| [gc_wait_archive](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576384) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [global_index_build_single_replica_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576472) | 实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。 |
| [global_major_freeze_residual_memory](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576298) | 使用率较低，从 V4.0.0 版本开始删除。 |
| [get_leader_candidate_rpc_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576281) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [ignore_replica_checksum_error](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576482) | 不建议使用，从 V4.0.0 版本开始删除。 |
| [index_clog_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576274) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [index_info_block_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576339) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [index_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576479) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [ilog_index_expire_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576242) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [location_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576484) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [location_cache_expire_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576303) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [log_archive_batch_buffer_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576367) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [log_archive_checkpoint_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576272) | 架构升级变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [archive_lag_target](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576137) 替代该配置项。 |
| [max_kept_major_version_number](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576437) | 使用率较低，从 V4.0.0 版本开始删除。 |
| [merge_stat_sampling_ratio](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576253) | 实现方式变更，从 V4.0.0 版本开始删除。 |
| [merge_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576448) | 实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [compaction_low_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576139) 替代该配置项。 |
| [merger_completion_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576431) | 使用率较低，从 V4.0.0 版本开始删除。 |
| [merger_switch_leader_duration_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576471) | 相应功能不再支持，从 V4.0.0 版本开始删除。 |
| [merger_warm_up_duration_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576368) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [migrate_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576277) | 实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [ha_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576192) 替代该配置项。 |
| [minor_deferred_gc_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576445) | 不建议使用，从 V4.0.0 版本开始删除。 |
| [minor_freeze_times](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576329) | 与配置项 `major_compact_trigger` 的含义一致，从 V4.0.0 版本开始删除该配置项，统一使用配置项 `major_compact_trigger`。 |
| [minor_merge_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576383) | 实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [compaction_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576149) 替代该配置项。 |
| [minor_warm_up_duration_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576291) | 不建议使用，从 V4.0.0 版本开始删除。 |
| [multiblock_read_gap_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576411) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [multiblock_read_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576252) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [ob_esi_rpc_port](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576382) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [enable_ob_esi_process](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576311) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [ob_esi_session_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576299) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [ob_esi_io_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576446) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [ob_esi_memory_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576369) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [ob_esi_syslog_level](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576327) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [ob_esi_max_syslog_file_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576455) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [ofs_list](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576461) | 相应功能不再适用，从 V4.0.0 版本开始删除。 |
| [partition_table_check_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576288) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [rebuild_replica_data_lag_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576412) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [replica_safe_remove_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576481) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [resource_soft_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576452) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [restore_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576267) | 实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [ha_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576191) 替代该配置项。 |
| [row_purge_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576404) | 相关功能一直未支持，从 V4.0.0 版本开始删除。 |
| [server_data_copy_out_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576405) | 实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [ha_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576192) 替代该配置项。 |
| [server_data_copy_in_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576317) | 实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 [ha_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576192) 替代该配置项。 |
| [sql_audit_memory_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576449) | 实现逻辑变更，相应功能已不再适用，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增变量 [ob_sql_audit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576522) 替代该配置项。 |
| [switchover_process_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576433) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [sys_bkgd_io_high_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576300) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [sys_bkgd_io_low_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576287) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [sys_cpu_limit_trigger](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576251) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [system_cpu_quota](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576276) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [tenant_groups](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576255) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [trx_force_kill_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576362) | 实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。 |
| [unit_balance_resource_weight](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576305) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [user_iort_up_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576332) | 实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。 |
| [user_tab_col_stat_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576324) | 实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。 |
| [wait_leader_batch_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576248) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [zone_merge_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576312) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [zone_merge_order](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576319) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |
| [zone_merge_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576270) | 相关功能不再支持，从 V4.0.0 版本开始删除。 |

## V4.x 版本中系统变量相关的变更

为了更好地适配用户的业务使用场景，OceanBase 数据库针对租户变量的默认值、取值范围等也进行了一系列的优化调整。特别地，在之前的版本中，`undo_retention` 是作为系统变量引入的，而在 V4.x 版本中，从 V4.0.0 版本开始，`undo_retention` 调整为租户级配置项。

### 更改默认值的系统变量

下表列出了更改默认值的变量。

| 变量名 | 描述 |
| --- | --- |
| [ob_default_lob_inrow_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576550) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始，默认值由 4096 调整为 8192。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始，默认值由 4096 调整为 8192。 |
| [sql_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576623) | - 对于 V4.3.x 版本，从 V4.3.0 版本开始，默认值由 “STRICT_ALL_TABLES,NO_ZERO_IN_DATE” 变更为 “STRICT_ALL_TABLES,NO_ZERO_IN_DATE,NO_AUTO_CREATE_USER”。 - 对于 V4.2.x 版本，从 V4.2.2 版本开始，默认值由 “STRICT_ALL_TABLES,NO_ZERO_IN_DATE” 变更为 “STRICT_ALL_TABLES,NO_ZERO_IN_DATE,NO_AUTO_CREATE_USER”。 |
| [optimizer_features_enable](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576581) | - 对于 V4.2.1 版本，V4.2.1 BP6 及之前版本，默认值为空，表示使用 V4.2.1.0 的优化器能力；从 V4.2.1 BP7 版本开始，默认值调整为当前四位数版本号，表示新建的集群可以使用新版优化器能力，而从 V4.2.1 BP6 及之前版本升级后依然使用升级前指定的优化器版本。 - 对于 V4.2.1 以外的其他版本，默认值仍为空，无变更。 |
| [secure_file_priv](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576585) | 从 V4.2.1 版本开始，默认值由 `NULL` 调整为 `""`。 |
| [max_allowed_packet](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576602) | 从 V4.2.1 版本开始，默认值由 4194304 调整为 16777216。 |
| [ob_max_read_stale_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576600) | 从 V4.1.0 版本开始，默认值由 5000000 调整为 -1。 |
| [ob_trx_idle_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576505) | 从 V4.0.0 版本开始，默认值由 120s 调整为 1d。 |
| [ob_trx_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576566) | 从 V4.0.0 版本开始，默认值 100s 调整为 1d。 |

### 更改取值范围或取值含义的系统变量

下表列出了更改取值范围或取值含义的系统变量。

| 变量名 | 描述 |
| --- | --- |
| [secure_file_priv](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576585) | 从 V4.2.0 版本开始，枚举值空字符串（`""`）和 `NULL` 的含义由原来的 “无限制” 调整为 “导入、导出被禁用”。 |
| [ob_max_read_stale_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576600) | 从 V4.1.0 版本开始，取值范围由 [0, 9223372036854775807] 修改为 [-1, 9223372036854775807]。 |

### 更改权限要求的系统变量

下表列出了更改权限要求的变量。

| 变量名 | 描述 |
| --- | --- |
| [secure_file_priv](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576585) | 从 V4.2.0 版本开始，限制只通过本地 Unix Socket 连接才能修改该变量。 |

### 新增的系统变量

下表列出了在 V4.x 版本中新增的系统变量。

| 变量名 | 引入版本 | 描述 |
| --- | --- | --- |
| [ob_hnsw_ef_search](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576492) | V4.3.3 | 于设定 HNSW 向量索引搜索时考虑的邻居节点数。 |
| [ob_table_access_policy](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576653) | V4.3.3 | 控制优化器生成基表计划时优先选择特定的存储格式。 |
| [cardinality_estimation_model](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576567) | - 对于 V4.3.x 版本，从 V4.3.3 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.4 版本开始引入。 | 控制优化器估行时使用的相关性模型。 |
| [activate_all_roles_on_login](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576525) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 控制在登录时是否默认自动启用所有 Roles。 |
| [innodb_stats_persistent](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576595) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 控制是否将 InnoDB 索引统计信息持久化到磁盘上。 |
| [ob_compatibility_control](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576579) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 用于控制 MYSQL5.7、 MYSQL8.0 有兼容性冲突时的行为模式。 |
| [ob_compatibility_version](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576648) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 控制产品行为发生变更的功能兼容的 OceanBase 数据库版本。 |
| [ob_security_version](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576564) | - 对于 V4.3.x 版本，从 V4.3.2 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.3 版本开始引入。 | 控制安全功能兼容的 OceanBase 数据库版本。 |
| [automatic_sp_privileges](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576591) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.2 版本开始引入。 | 设置在存储过程中是否被自动授予 ALTER 和 EXECUTE 的权限。 |
| [lc_time_names](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576502) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.2 版本开始引入。 | 控制显示日期和月份名称和缩写的语言。 |
| [ob_enable_pl_cache](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576548) | - 对于 V4.3.x 版本，从 V4.3.1 版本开始引入。 - 对于 V4.2.x 版本，从 V4.2.2 版本开始引入。 | 控制 PL cache 模块是否开启。 |
| [optimizer_dynamic_sampling](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576594) | V4.2.0 | 控制动态采样的等级。 |
| [optimizer_features_enable](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576581) | V4.2.0 | 启用不同 OceanBase 版本优化器功能。 |
| [parallel_degree_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576575) | V4.2.0 | 设置在使用 Auto DOP 策略时，优化器选择并行度的上限值。 |
| [parallel_degree_policy](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576517) | V4.2.0 | 设置并行度选择策略。 |
| [parallel_min_scan_time_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576578) | V4.2.0 | 在 Auto DOP 策略中用于计算并行度的参数，即设置对基表扫描进行并行处理的最小评估执行时间。 |
| [runtime_filter_type](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576642) | V4.2.0 | 设置租户级别的 Runtime Filter 类型。 |
| [runtime_filter_wait_time_ms](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576587) | V4.2.0 | 设置 Runtime Filter 的最大等待时间。 |
| [runtime_filter_max_in_num](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576650) | V4.2.0 | 设置 Runtime In Filter 的 NDV （某个列中不同值的个数）个数。 |
| [runtime_bloom_filter_max_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576649) | V4.2.0 | 设置 Runtime Bloom Filter 的最大使用内存，单位为字节。 |
| [cte_max_recursion_depth](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576655) | V4.1.0 | 设置公共表表达式（CTE）的最大递归深度。服务器会终止执行任何超过此 CTE 值的操作。 |
| [ob_max_read_stale_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576600) | V4.1.0 | 设置弱读取查询的最大延迟阈值（us）。 |
| [regexp_stack_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576507) | V4.1.0 | 设置正则表达式匹配操作的内部堆栈的最大可用内存，默认单位为字节。 |
| [ob_enable_show_trace](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576496) | V4.1.0 | 设置是否使用 Show Trace 日志。 |
| [cursor_sharing](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576559) | V4.0.0 | 判断处理 SQL 时是否进行参数化。 |
| [innodb_strict_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576555) | V4.0.0 | 设置特定语法的 SQL 检查模式。 |
| [log_row_value_options](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576520) | V4.0.0 | 控制 Lob 是否使用部分更新。 |
| [ob_enable_rich_error_msg](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576628) | V4.0.0 | 控制 SQL 执行出错时是否显示 svr_ip、time、trace_id 等信息。 |

### 废弃的系统变量

下表中列出了在 V4.x 版本中被废弃的系统变量。

| 变量名 | 描述 |
| --- | --- |
| ob_enable_trace_log | 架构升级变更，从 V4.1.0 版本开始删除。 |
| [ob_create_table_strict_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576620) | 架构升级变更，从 V4.0.0 版本开始删除。 |
| [ob_enable_blk_nestedloop_join](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576533) | 实现逻辑变更，相应功能不适用，从 V4.0.0 版本开始删除。 |
| [ob_enable_hash_group_by](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576596) | 实现方式变更，从 V4.0.0 版本开始删除。 |
| [ob_timestamp_service](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001576604) | 架构升级变更，从 V4.0.0 版本开始删除。 |

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线