V3.x 与 V4.x 配置项和系统变量变更 - OceanBase 数据库 V4.3.4

由于 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	ha_low_thread_score	替换后的配置项为租户级别
clog_disk_utilization_threshold	log_disk_utilization_threshold	替换后的配置项为租户级别
clog_transport_compress_func	log_transport_compress_func	替换后的配置项为租户级别
data_copy_concurrency、fast_recovery_concurrency、restore_concurrency	ha_high_thread_score	替换后的配置项为租户级别
log_archive_checkpoint_interval	archive_lag_target	替换后的配置项为租户级别
merge_thread_count	compaction_low_thread_score	替换后的配置项为租户级别
migrate_concurrency 、server_data_copy_out_concurrency、server_data_copy_in_concurrency	ha_mid_thread_score	替换后的配置项为租户级别
sql_audit_memory_limit	ob_sql_audit_percentage	替换为租户变量，不再是配置项
minor_merge_concurrency	compaction_mid_thread_score	替换后的配置项为租户级别
clog_persistence_compress_func	log_storage_compress_func	替换后的配置项为租户级别
enable_clog_persistence_compress	log_storage_compress_all	替换后的配置项为租户级别

更改名称的配置项

下表列出了在 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	对于 V4.3.x 版本，从 V4.3.0 版本开始，由集群级变更为租户级。对于 V4.2.x 版本，从 V4.2.1 BP2 版本开始，由集群级变更为租户级。
enable_rebalance	从 V4.2.0 版本开始，由集群级变更为租户级。
balancer_idle_time	从 V4.2.0 版本开始，由集群级变更为租户级。
log_archive_concurrency	从 V4.1.0 版本开始，由集群级变更为租户级。
log_restore_concurrency	从 V4.1.0 版本开始，由集群级变更为租户级。
major_compact_trigger	从 V4.0.0 版本开始，由集群级变更为租户级。
minor_compact_trigger	从 V4.0.0 版本开始，由集群级变更为租户级。

更改生效模式的配置项

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

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

配置项名	描述
server_cpu_quota_min	对于 V4.3.x 版本，从 V4.3.0 版本开始，生效模式由重启生效变更为立即生效。对于 V4.2.x 版本，暂未更改生效模式。
server_cpu_quota_max	对于 V4.3.x 版本，从 V4.3.0 版本开始，生效模式由重启生效变更为立即生效。对于 V4.2.x 版本，暂未更改生效模式。

更改默认值的配置项

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

配置项名	描述
memstore_limit_percentage	对于 V4.3.x 版本，从 V4.3.0 版本开始，默认值由 50 调整为 0。对于 V4.2.x 版本，从 V4.2.3 版本开始，默认值由 50 调整为 0。
range_optimizer_max_mem_size	对于 V4.3.x 版本，从 V4.3.0 版本开始，默认值由 128 M 调整为 0M。对于 V4.2.x 版本，从 V4.2.2 版本开始，默认值由 128 M 调整为 0M。
ls_gc_delay_time	对于 V4.3.x 版本，从 V4.3.0 版本开始，默认值由 1h 调整为 0s。对于 V4.2.x 版本，从 V4.2.1 BP1 版本开始，默认值由 1h 调整为 0s。
enable_monotonic_weak_read	从 V4.2.1 版本开始，默认值由 true 调整为 false。
location_refresh_thread_count	从 V4.2.0 版本开始，默认值由 4 调整为 2。
enable_record_trace_id	从 V4.2.0 版本开始，默认值由 true 调整为 false。
plan_cache_evict_interval	从 V4.2.0 版本开始，默认值由 1s 调整为 5s。
tenant_task_queue_size	从 V4.1.0 版本开始，默认值由 65536 调整为 16384。
server_cpu_quota_min	从 V4.2.1 版本开始，默认值由 1 调整为 0。从 V4.0.0 版本开始，默认值由 2.5 调整为 1。
writing_throttling_maximum_duration	从 V4.0.0 版本开始，默认值由 1h 调整为 2h。
writing_throttling_trigger_percentage	从 V4.0.0 版本开始，默认值由 100 调整为 60。
freeze_trigger_percentage	从 V4.0.0 版本开始，默认值由 70 调整为 20。

更改取值范围的配置项

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

配置项名	描述
ob_startup_mode	从 V4.3.4 版本开始，取值范围中增加 `SHARED_STORAGE` 的取值。
large_query_threshold	对于 V4.3.x 版本，从 V4.3.0 版本开始，取值范围由 [1ms, +∞) 变更为 [0ms, +∞)。对于 V4.2.x 版本，从 V4.2.3 版本开始，取值范围由 [1ms, +∞) 变更为 [0ms, +∞)。
memstore_limit_percentage	对于 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	对于 V4.3.x 版本，从 V4.3.0 版本开始，取值范围由 [16M，1G] 调整为 [0M，+∞)。对于 V4.2.x 版本，从 V4.2.2 版本开始，取值范围由 [16M，1G] 调整为 [0M，+∞)。
job_queue_processes	对于 V4.3.x 版本，从 V4.3.0 版本开始，取值范围由 [0,1000] 调整为 [0,16384]。对于 V4.2.x 版本，从 V4.2.1 BP1 版本开始，取值范围由 [0,1000] 调整为 [0,16384]。
memory_limit_percentage	从 V4.2.1 版本开始，取值范围由 [10, 90] 调整为 [10, 95]。
cpu_quota_concurrency	从 V4.2.0 版本开始，取值范围由 [1,10] 调整为 [1,20]。
memory_limit	从 V4.1.0 版本开始，取值范围由 [4G, +∞) 调整为 [1G, +∞)。
server_cpu_quota_min	从 V4.2.1 版本开始，取值范围由 [1，16] 调整为 [0, 16]。从 V4.0.0 版本开始，取值范围由 [0，16] 调整为 [1, 16]。

更改语义的配置项

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

配置项名	描述
datafile_maxsize	从 V4.3.4 版本开始，无共享（Shared-Nothing，SN）模式下，该配置项语义不变；共享存储（Shared-Storage，SS）模式下，该配置项无意义。
datafile_next	从 V4.3.4 版本开始，无共享（Shared-Nothing，SN）模式下，该配置项语义不变；共享存储（Shared-Storage，SS）模式下，该配置项无意义。
datafile_disk_percentage	从 V4.3.4 版本开始，无共享（Shared-Nothing，SN）模式下，该配置项语义不变；共享存储（Shared-Storage，SS）模式下，该配置项用于设置本地可用缓存空间占磁盘总空间的百分比。
datafile_size	从 V4.3.4 版本开始，无共享（Shared-Nothing，SN）模式下，该配置项语义不变；共享存储（Shared-Storage，SS）模式下，该配置项用于设置本地缓存空间的大小。

新增的配置项

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

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

废弃的配置项

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

配置项名	描述
global_write_halt_residual_memory	相关功能不再使用，从 V4.2.0 版本开始删除。
max_px_worker_count	相关功能不再使用，从 V4.2.0 版本开始删除。
plan_cache_high_watermark	相关功能一直未支持，从 V4.2.0 版本开始删除。
plan_cache_low_watermark	相关功能一直未支持，从 V4.2.0 版本开始删除。
rootservice_memory_limit	架构升级变更，从 V4.2.0 版本开始删除。
system_trace_level	实现逻辑变更，该配置项已不适用，从 V4.2.0 版本开始删除。
token_reserved_percentage	实现逻辑变更，该配置项已不适用，从 V4.2.0 版本开始删除。
trace_log_sampling_interval	实现逻辑变更，该配置项已不适用，从 V4.2.0 版本开始删除。
io_category_config	实现逻辑变更，该配置项已不适用，从 V4.2.0 版本开始删除。
auto_broadcast_location_cache_rate_limit	架构升级变更，从 V4.0.0 版本开始删除。
auto_leader_switch_interval	架构升级变更，从 V4.0.0 版本开始删除。
auto_refresh_location_cache_rate_limit	架构升级变更，从 V4.0.0 版本开始删除。
backup_backup_dest	相关功能不再支持，从 V4.0.0 版本开始删除。
backup_backup_dest_option	相关功能不再支持，从 V4.0.0 版本开始删除。
backup_dest_option	架构升级变更，从 V4.0.0 版本开始删除。
backup_concurrency	架构升级变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 ha_low_thread_score 替代该配置项。
backup_dest	架构升级变更，从 V4.0.0 版本开始删除。
backup_log_archive_option	架构升级变更，从 V4.0.0 版本开始删除。
backup_net_limit	架构升级变更，从 V4.0.0 版本开始删除。
backup_recovery_window	架构升级变更，从 V4.0.0 版本开始删除。
backup_region	架构升级变更，从 V4.0.0 版本开始删除。
backup_zone	架构升级变更，从 V4.0.0 版本开始删除。
balance_blacklist_failure_threshold	架构升级变更，从 V4.0.0 版本开始删除。
balance_blacklist_retry_interval	架构升级变更，从 V4.0.0 版本开始删除。
balancer_emergency_percentage	架构升级变更，从 V4.0.0 版本开始删除。
balancer_timeout_check_interval	架构升级变更，从 V4.0.0 版本开始删除。
clog_disk_utilization_threshold	架构升级变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 log_disk_utilization_threshold 替代该配置项。
clog_expire_days	架构升级变更，从 V4.0.0 版本开始删除。
clog_cache_priority	架构升级变更，从 V4.0.0 版本开始删除。
clog_disk_usage_limit_percentage	架构升级变更，从 V4.0.0 版本开始删除。
clog_transport_compress_func	V4.0.0 版本暂未支持该功能，从 V4.0.0 版本开始删除。从 V4.1.0 版本开始新增配置项 log_transport_compress_func 替代该配置项。
clog_max_unconfirmed_log_count	实现逻辑变更，相关功能不再适用，从 V4.0.0 版本开始删除。
clog_persistence_compress_func	相关功能在 V4.0.0 版本未支持，从 V4.0.0 版本开始删除。从 V4.2.1 版本开始（不含 V4.3.0 版本）重新支持，新增 log_storage_compress_func 替代该配置项。
cpu_reserved	架构升级变更，从 V4.0.0 版本开始删除。
data_copy_concurrency	实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 ha_high_thread_score 替代该配置项。
default_transport_compress_func	架构升级变更，从 V4.0.0 版本开始删除。
election_cpu_quota	架构升级变更，从 V4.0.0 版本开始删除。
election_blacklist_interval	架构升级变更，从 V4.0.0 版本开始删除。
enable_auto_refresh_location_cache	架构升级变更，从 V4.0.0 版本开始删除。
enable_auto_leader_switch	架构升级变更，从 V4.0.0 版本开始删除。
enable_clog_persistence_compress	相关功能在 V4.0.0 版本未支持，从 V4.0.0 版本开始删除。从 V4.2.1 版本开始（不含 V4.3.0 版本）重新支持，新增 log_storage_compress_all 替代该配置项。
enable_global_freeze_trigger	架构升级变更，从 V4.0.0 版本开始删除。
enable_log_archive	架构升级变更，从 V4.0.0 版本开始删除。
enable_election_group	架构升级变更，从 V4.0.0 版本开始删除。
enable_merge_by_turn	相关功能不再支持，从 V4.0.0 版本开始删除。
enable_manual_merge	相关功能不再支持，从 V4.0.0 版本开始删除。
enable_one_phase_commit	实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。
enable_pg	架构升级变更，从 V4.0.0 版本开始删除。
enable_separate_sys_clog	相关功能一直未生效，从 V4.0.0 版本开始删除。
enable_smooth_leader_switch	架构升级变更，从 V4.0.0 版本开始删除。
enable_rootservice_standalone	架构升级变更，从 V4.0.0 版本开始删除。
fast_recovery_concurrency	实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 ha_high_thread_score 替代该配置项。
flush_log_at_trx_commit	使用率较低，从 V4.0.0 版本开始删除。
gc_wait_archive	架构升级变更，从 V4.0.0 版本开始删除。
global_index_build_single_replica_timeout	实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。
global_major_freeze_residual_memory	使用率较低，从 V4.0.0 版本开始删除。
get_leader_candidate_rpc_timeout	架构升级变更，从 V4.0.0 版本开始删除。
ignore_replica_checksum_error	不建议使用，从 V4.0.0 版本开始删除。
index_clog_cache_priority	架构升级变更，从 V4.0.0 版本开始删除。
index_info_block_cache_priority	架构升级变更，从 V4.0.0 版本开始删除。
index_cache_priority	架构升级变更，从 V4.0.0 版本开始删除。
ilog_index_expire_time	架构升级变更，从 V4.0.0 版本开始删除。
location_cache_priority	架构升级变更，从 V4.0.0 版本开始删除。
location_cache_expire_time	架构升级变更，从 V4.0.0 版本开始删除。
log_archive_batch_buffer_limit	架构升级变更，从 V4.0.0 版本开始删除。
log_archive_checkpoint_interval	架构升级变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 archive_lag_target 替代该配置项。
max_kept_major_version_number	使用率较低，从 V4.0.0 版本开始删除。
merge_stat_sampling_ratio	实现方式变更，从 V4.0.0 版本开始删除。
merge_thread_count	实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 compaction_low_thread_score 替代该配置项。
merger_completion_percentage	使用率较低，从 V4.0.0 版本开始删除。
merger_switch_leader_duration_time	相应功能不再支持，从 V4.0.0 版本开始删除。
merger_warm_up_duration_time	架构升级变更，从 V4.0.0 版本开始删除。
migrate_concurrency	实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 ha_mid_thread_score 替代该配置项。
minor_deferred_gc_time	不建议使用，从 V4.0.0 版本开始删除。
minor_freeze_times	与配置项 `major_compact_trigger` 的含义一致，从 V4.0.0 版本开始删除该配置项，统一使用配置项 `major_compact_trigger`。
minor_merge_concurrency	实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 compaction_mid_thread_score 替代该配置项。
minor_warm_up_duration_time	不建议使用，从 V4.0.0 版本开始删除。
multiblock_read_gap_size	架构升级变更，从 V4.0.0 版本开始删除。
multiblock_read_size	架构升级变更，从 V4.0.0 版本开始删除。
ob_esi_rpc_port	相关功能不再支持，从 V4.0.0 版本开始删除。
enable_ob_esi_process	相关功能不再支持，从 V4.0.0 版本开始删除。
ob_esi_session_timeout	相关功能不再支持，从 V4.0.0 版本开始删除。
ob_esi_io_concurrency	相关功能不再支持，从 V4.0.0 版本开始删除。
ob_esi_memory_limit	相关功能不再支持，从 V4.0.0 版本开始删除。
ob_esi_syslog_level	相关功能不再支持，从 V4.0.0 版本开始删除。
ob_esi_max_syslog_file_count	相关功能不再支持，从 V4.0.0 版本开始删除。
ofs_list	相应功能不再适用，从 V4.0.0 版本开始删除。
partition_table_check_interval	架构升级变更，从 V4.0.0 版本开始删除。
rebuild_replica_data_lag_threshold	架构升级变更，从 V4.0.0 版本开始删除。
replica_safe_remove_time	架构升级变更，从 V4.0.0 版本开始删除。
resource_soft_limit	架构升级变更，从 V4.0.0 版本开始删除。
restore_concurrency	实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 ha_high_thread_score 替代该配置项。
row_purge_thread_count	相关功能一直未支持，从 V4.0.0 版本开始删除。
server_data_copy_out_concurrency	实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 ha_mid_thread_score 替代该配置项。
server_data_copy_in_concurrency	实现逻辑变更，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增配置项 ha_mid_thread_score 替代该配置项。
sql_audit_memory_limit	实现逻辑变更，相应功能已不再适用，从 V4.0.0 版本开始删除。从 V4.0.0 版本开始新增变量 ob_sql_audit_percentage 替代该配置项。
switchover_process_thread_count	架构升级变更，从 V4.0.0 版本开始删除。
sys_bkgd_io_high_percentage	架构升级变更，从 V4.0.0 版本开始删除。
sys_bkgd_io_low_percentage	架构升级变更，从 V4.0.0 版本开始删除。
sys_cpu_limit_trigger	架构升级变更，从 V4.0.0 版本开始删除。
system_cpu_quota	架构升级变更，从 V4.0.0 版本开始删除。
tenant_groups	相关功能不再支持，从 V4.0.0 版本开始删除。
trx_force_kill_threshold	实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。
unit_balance_resource_weight	架构升级变更，从 V4.0.0 版本开始删除。
user_iort_up_percentage	实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。
user_tab_col_stat_cache_priority	实现逻辑变更，相应功能不再适用，从 V4.0.0 版本开始删除。
wait_leader_batch_count	架构升级变更，从 V4.0.0 版本开始删除。
zone_merge_concurrency	相关功能不再支持，从 V4.0.0 版本开始删除。
zone_merge_order	相关功能不再支持，从 V4.0.0 版本开始删除。
zone_merge_timeout	相关功能不再支持，从 V4.0.0 版本开始删除。

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

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

更改默认值的系统变量

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

变量名	描述
ob_default_lob_inrow_threshold	对于 V4.3.x 版本，从 V4.3.2 版本开始，默认值由 4096 调整为 8192。对于 V4.2.x 版本，从 V4.2.3 版本开始，默认值由 4096 调整为 8192。
sql_mode	对于 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	对于 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	从 V4.2.1 版本开始，默认值由 `NULL` 调整为 `""`。
max_allowed_packet	从 V4.2.1 版本开始，默认值由 4194304 调整为 16777216。
ob_max_read_stale_time	从 V4.1.0 版本开始，默认值由 5000000 调整为 -1。
ob_trx_idle_timeout	从 V4.0.0 版本开始，默认值由 120s 调整为 1d。
ob_trx_timeout	从 V4.0.0 版本开始，默认值 100s 调整为 1d。

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

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

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

更改权限要求的系统变量

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

变量名	描述
secure_file_priv	从 V4.2.0 版本开始，限制只通过本地 Unix Socket 连接才能修改该变量。

新增的系统变量

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

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

废弃的系统变量

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

变量名	描述
ob_enable_trace_log	架构升级变更，从 V4.1.0 版本开始删除。
ob_create_table_strict_mode	架构升级变更，从 V4.0.0 版本开始删除。
ob_enable_blk_nestedloop_join	实现逻辑变更，相应功能不适用，从 V4.0.0 版本开始删除。
ob_enable_hash_group_by	实现方式变更，从 V4.0.0 版本开始删除。
ob_timestamp_service	架构升级变更，从 V4.0.0 版本开始删除。