---
title: "系统配置项总览 | OceanBase 文档中心"
description: 系统配置项总览 本文根据配置项的功能， 详细地罗列了 OceanBase 数据库的集群级配置项和租户级配置项。 集群级配置项 带宽相关 配置项名 功能描述 enable_ob_ratelimit 用于在 RPC 连接中，启用区域之间的速率限制。 ob_ratelimit_stat_period 用于设置 OBServ…
---
切换语言

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

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

# 系统配置项总览

更新时间：2026-07-05 09:03:39

本文根据配置项的功能， 详细地罗列了 OceanBase 数据库的集群级配置项和租户级配置项。

## 集群级配置项

### 带宽相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_ob_ratelimit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944989) | 用于在 RPC 连接中，启用区域之间的速率限制。 |
| [ob_ratelimit_stat_period](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944375) | 用于设置 OBServer 计算和更新最大带宽的时间间隔。 |

### 负载均衡相关

| 配置项名 | 功能描述 |
| --- | --- |
| [balancer_idle_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944939) | 用于设置负载均衡等后台任务线程空闲时的唤醒间隔时间。 |
| [balancer_log_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944940) | 用于负载均衡等后台任务线程打印统计日志的间隔时间。 |
| [balancer_timeout_check_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944942) | 用于设置检查负载均衡等后台任务超时的时间间隔。 |
| [balancer_task_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944941) | 用于设置负载均衡等后台任务的超时时间。 |
| [balancer_tolerance_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944943) | 用于设置负载均衡策略中，租户内多个 Unit 间磁盘不均衡程度的宽容度，如果在均值 + 或 - 宽容度范围之内，不会触发执行均衡动作。 |
| [balancer_emergency_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944938) | 用于设置 Unit 负载阈值，即当 Unit 负载超过该阈值时，允许开启副本向外迁移，即使在合并期间也执行负载均衡。 |
| [enable_rebalance](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944993) | 用于设置是否开启自动负载均衡的功能。 |
| [server_balance_critical_disk_waterlevel](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944404) | 用于设置磁盘空间的负载均衡功能的水位线。 |
| [server_balance_disk_tolerance_percent](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944405) | 用于设置节点间磁盘负载均衡策略中不均衡程度的容忍度。 |
| [tenant_groups](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945136) | 用于设置负载均衡策略中使用的租户组。 |
| [resource_hard_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944388) | 用于分配 Unit 。 |
| [resource_soft_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944389) | 用于设置是否开启 Unit 均衡。 |
| [unit_balance_resource_weight](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945144) | 用于设置 Unit 均衡策略中使用的资源权重，一般不需要手工配置。 |
| [enable_sys_unit_standalone](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945003) | 用于设置系统租户的 Unit 是否独占节点。 |

### 副本相关

| 配置项名 | 功能描述 |
| --- | --- |
| [balance_blacklist_failure_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944936) | 用于设置副本迁移等后台任务连续失败次数的阈值。 |
| [balance_blacklist_retry_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944937) | 用于设置副本迁移等后台任务被放入黑名单后的重试时间间隔。 |
| [enable_rereplication](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944996) | 用于设置是否开启自动补副本的功能。 |
| [global_index_build_single_replica_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945017) | 用于建全局索引时，设置每个副本构建的超时时间。 |
| [ignore_replica_checksum_error](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945022) | 用于设置是否忽略多副本间校验和检查发生的错误。 |
| [replica_safe_remove_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944387) | 用于设置已删除副本可以被清理的安全保留时间。 |
| [sys_bkgd_migration_change_member_list_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944421) | 用于设置副本迁移时变更 Paxos 成员组操作的超时时间。 |
| [sys_bkgd_migration_retry_num](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944422) | 用于设置副本迁移失败时最多重试次数。 |
| [enable_smooth_leader_switch](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945000) | 表示平滑切主特性的开关。 |
| [election_blacklist_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944977) | 用于设置主副本被废除后不允许再被选为主的时间间隔。 |
| [enable_auto_leader_switch](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944980) | 用于设置是否开启自动切主。 |
| [get_leader_candidate_rpc_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945016) | 用于设置自动切主策略获取切主候选者的内部请求超时时间。 |
| [rebuild_replica_data_lag_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944385) | 用于设置备副本的事务日志和主副本差距的阈值，当超过该阈值时，会触发副本重建。 |

### 备份恢复相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_log_archive](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944985) | 用于设置是否开启日志归档功能。 |
| [backup_dest_option](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944930) | 用于控制备份相关的参数。 |
| [backup_backup_dest_option](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946185) | 用于控制备份备份相关的参数。 |
| [backup_log_archive_option](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944931) | 用于定义备份日志的归档选项。 |
| [backup_zone](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944935) | 用于用户指定执行备份的 Zone。 |
| [log_archive_checkpoint_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944341) | 用于设置冷数据的日志归档检查点的时间间隔。 |
| [log_archive_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944342) | 用于设置日志归档的并发度。 |
| [log_archive_batch_buffer_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944340) | 当物理备份开启时，该配置项用于控制日志归档单机的最大内存使用量。 |
| [log_restore_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944343) | 用于设置恢复日志的并发度。 |
| [auto_delete_expired_backup](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946164) | 用于设置是否开启自动删除过期备份的功能。 |
| [backup_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946188) | 用于设置备份时写文件系统的并发数量。 |
| [backup_dest](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946189) | 用于设置基线备份和日志归档的路径。 |
| [backup_net_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944932) | 用于设置集群备份的总带宽。 |
| [backup_recovery_window](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944933) | 用于设置备份数据可以恢复的时间。 |
| [backup_region](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944934) | 用于用户指定执行备份的 Region。 |
| [restore_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944390) | 用于设置从备份恢复租户数据时的最大并发度。 |
| [backup_backup_dest](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946181) | 用于设置备份数据备份的目的端。 |
| [backup_backup_archive_log_batch_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946175) | 用于设置备份备份日志的任务的批次数量。 |
| [backup_backup_archivelog_retry_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946178) | 用于设置备份备份日志的任务的重试间隔。 |
| [backup_backupset_batch_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946184) | 用于设置备份备份基线的任务的批次数量。 |
| [backup_backupset_retry_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946187) | 用于设置备份备份基线的任务的重试间隔。 |

### 主备库相关

| 配置项名 | 功能描述 |
| --- | --- |
| [switchover_process_thread_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944418) | 用于设置主备库切换相关线程池的大小。 |

### 集群相关

| 配置项名 | 功能描述 |
| --- | --- |
| [cluster](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944955) | 用于设置本 OceanBase 集群名。 |
| [cluster_id](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944956) | 用于设置本 OceanBase 集群 ID。 |
| [rpc_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944400) | 用于设置集群内部请求的超时时间。 |

### SQL 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [sql_login_thread_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945165) | 用于设置处理 SQL 登录请求的线程数量。 |

### 外部存储接口相关

| 配置项名 | 功能描述 |
| --- | --- |
| [ob_esi_rpc_port](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945158) | 用于设置 obesi 进程和 observer 进程之间的通信端口。 |
| [enable_ob_esi_process](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945159) | 用于控制是否启用 obesi（外部存储接口）进程。 |
| [ob_esi_session_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945160) | 用于设置 obesi 进程持有活动会话资源的超时时间。 |
| [ob_esi_io_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945161) | 用于设置 obesi 进程的并发 I/O 数。 |
| [ob_esi_memory_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945162) | 用于设置 obesi 进程的内存使用上限。 |
| [ob_esi_syslog_level](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945163) | 用于设置 obesi 进程的当前日志记录级别。 |
| [ob_esi_max_syslog_file_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945164) | 用于设置 obesi 进程在回收日志文件之前可以容纳的的最大日志文件数量。 |

### CPU 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [cpu_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944958) | 用于设置系统 CPU 总数。如果设置为 0，系统将自动检测 CPU 数量。 |
| [cpu_quota_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944959) | 用于设置租户的每个 CPU 配额所允许的最大并发数。 |
| [cpu_reserved](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944960) | 用于设置系统预留的 CPU 数量，其余 CPU 将被 OceanBase 数据库独占使用。 |
| [election_cpu_quota](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944978) | 用于设置给副本选举相关的后台工作分配的 CPU 配额。 |
| [server_balance_cpu_mem_tolerance_percent](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944403) | 在节点负载均衡策略中，用于设置 CPU 和内存资源不均衡的容忍度。 |
| [server_cpu_quota_max](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944407) | 用于设置系统可以使用的最大 CPU 配额。 |
| [server_cpu_quota_min](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944408) | 用于设置系统可以使用的最小 CPU 配额，系统会自动预留。 |
| [system_cpu_quota](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944427) | 用于设置系统租户可使用的 CPU 配额。 |
| [sys_cpu_limit_trigger](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944424) | 用于设置 CPU 利用率阈值，即当 CPU 利用率超过该阈值时，将暂停系统后台任务的执行。 |
| [token_reserved_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945138) | 在控制租户 CPU 调度中，用于设置每次预留多少比例的空闲 token 数给租户。 |
| [workers_per_cpu_quota](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945153) | 用于设置分配给每个 CPU 配额的工作线程数量。 |

### 目录路径相关

| 配置项名 | 功能描述 |
| --- | --- |
| [config_additional_dir](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944957) | 用于设置本地存储配置文件的多个目录，为了冗余存储多份配置文件。 |
| [data_dir](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944962) | 用于设置存储 SSTable 等数据的目录。 |

### 内存空间相关

| 配置项名 | 功能描述 |
| --- | --- |
| [datafile_disk_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944966) | 表示占用 data_dir 所在磁盘（磁盘 data_dir 所在磁盘将被 OceanBase 数据库系统初始化用于存储数据）总空间的百分比。 |
| [data_disk_usage_limit_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944963) | 用于设置数据文件最大可以写入的百分比，超过这个阈值后，禁止数据迁入。 |
| [enable_sql_operator_dump](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945002) | 用于设置是否允许 SQL 处理过程的中间结果写入磁盘以释放内存。 |
| [global_write_halt_residual_memory](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945019) | 用于设置触发暂停普通租户写入（`sys` 租户不受影响）的全局剩余内存阈值。 |
| [leak_mod_to_check](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944330) | 用于内存泄露检查，是属于内部调试的功能。 |
| [memory_chunk_cache_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944350) | 用于设置内存分配器缓存的内存块容量。 |
| [memory_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944351) | 表示可用的总内存大小。 |
| [memory_limit_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944352) | 用于设置系统总可用内存大小占总内存大小的百分比。 |
| [memory_reserved](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944353) | 用于设置系统预留给 KVCache 的内存容量。 |
| [memstore_limit_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944354) | 用于设置租户使用 MemStore 的内存占其总可用内存的百分比。 |
| [system_memory](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944428) | 用于设置系统预留给租户 ID 为 `500` 的租户的内存容量。 |
| [sql_audit_memory_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944413) | 用于设置 SQL 审计数据可占用的最大内存。 |
| [use_large_pages](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945145) | 用于管理数据库使用的内存大页。 |

### 调试相关

| 配置项名 | 功能描述 |
| --- | --- |
| [debug_sync_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944969) | 用于打开 Debug Sync 调试开关，并设置其超时时间。 |
| [enable_rich_error_msg](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944997) | 用于设置是否在客户端消息中添加服务器地址、时间、追踪 ID 等调试信息。 |

### 压缩算法相关

| 配置项名 | 功能描述 |
| --- | --- |
| [default_compress_func](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944971) | 用于设置表数据的默认压缩算法，也可以在建表的时候指定其他压缩算法。 |
| [default_compress](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944970) | 用于设置在 Oracle 模式下，建表时使用的默认压缩策略。 |
| [tableapi_transport_compress_func](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945130) | 用于设置 tableAPI 查询结果传输使用的压缩算法。 |
| [default_transport_compress_func](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944973) | 用于设置整个集群的 RPC 压缩算法。 |

### 事务及事务日志相关

| 配置项名 | 功能描述 |
| --- | --- |
| [trx_try_wait_lock_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945143) | 用于设置语句执行过程行锁的等待时长。 |
| [trx_force_kill_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945142) | 用于设置因冻结或切主需要 Kill 事务时的最长等待时间。 |
| [clog_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944948) | 用于设置事务日志占用缓存的优先级。 |
| [clog_sync_time_warn_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944952) | 用于设置事务日志同步耗时告警阈值，同步耗时超过该值产生 WARN 日志。 |
| [clog_disk_usage_limit_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944949) | 用于设置事务日志的磁盘 I/O 最大使用百分比。 |
| [clog_transport_compress_all](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944953) | 用于设置事务日志传输时是否压缩。 |
| [clog_transport_compress_func](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944954) | 用于设置事务日志内部传输时使用的压缩算法。 |
| [dtl_buffer_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944976) | 用于设置 SQL 数据传输模块使用的缓存大小。 |
| [enable_one_phase_commit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944990) | 用于设置是否开启事务提交一阶段优化的功能。 |
| [ignore_replay_checksum_error](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945021) | 用于设置是否忽略回放事务日志时发生的校验和错误。 |
| [trx_2pc_retry_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945141) | 用于设置两阶段提交失败时候自动重试的时间间隔。 |
| [clog_disk_utilization_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944950) | 用于控制 Clog 或 ilog 磁盘空间复用的水位值。 |
| [index_clog_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945025) | 用于设置事务日志索引在缓存系统中的优先级。 |
| [clog_expire_days](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944951) | 用于控制 Clog 文件的过期时间。当 Clog 文件最后修改时间距离当前时间超过过期时间时，该文件会被删除。 |
| [gc_wait_archive](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945015) | 用于设置分区 GC 时是否需要等待分区上所有日志归档完成。 |
| [max_trx_2pc_retry_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-1000000000364075) | 用于表示事务两阶段提交中消息重试的最大时间间隔。 |
| [max_trx_part_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-1000000001886187) | 用于控制单个事务中参与者个数的上限。 |

### 转储与合并相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_global_freeze_trigger](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944984) | 用于设置是否开启自动触发全局冻结。 |
| [enable_manual_merge](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944987) | 用于设置是否开启手工合并。 |
| [enable_merge_by_turn](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944988) | 用于设置是否开启轮转合并策略。 |
| [enable_major_freeze](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944986) | 用于设置是否开启自动全局冻结的功能。 |
| [freeze_trigger_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945013) | 用于设置触发全局冻结的租户使用内存阈值。 |
| [global_major_freeze_residual_memory](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945018) | 用于设置触发全局冻结的剩余内存阈值。 |
| [major_freeze_duty_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944345) | 用于设置每日定时冻结和合并的触发时刻。 |
| [max_kept_major_version_number](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944346) | 用于设置数据保留的冻结版本数量。 |
| [merge_stat_sampling_ratio](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944355) | 用于设置合并时候数据列统计信息的采样率。 |
| [major_compact_trigger](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944344) | 用于设置单个租户冻结多少次后触发一次全局合并。 |
| [merge_thread_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944356) | 用于设置每日合并工作的线程数。 |
| [merger_check_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944357) | 用于设置合并状态检查线程的调度间隔。 |
| [merger_completion_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944358) | 用于设置合并完成副本数的百分比阈值，达到该阈值则认为本轮合并完成调度。 |
| [merger_switch_leader_duration_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944359) | 用于设置每日合并时批量切主的时间间隔。 |
| [merger_warm_up_duration_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944360) | 用于设置合并时，新版基线数据的预热时间。 |
| [minor_compact_trigger](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944365) | 用于配置触发转储（Minor Compaction）的 SSTable 个数的阈值。 |
| [minor_deferred_gc_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944366) | 用于设置合并之后 SSTable 延迟回收的时间间隔。 |
| [minor_freeze_times](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944367) | 用于设置单个租户冻结多少次后触发一次全局合并。 |
| [minor_warm_up_duration_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944369) | 用于设置转储产生新转储文件的预热时间。 |
| [minor_merge_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944368) | 用于设置转储时的并发线程数。 |
| [micro_block_merge_verify_level](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944361) | 用于设置合并时宏块的校验级别。 |
| [row_compaction_update_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944397) | 用于设置触发内存中行内数据合并的修改次数。 |
| [row_purge_thread_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944398) | 用于设置执行内存中行内数据合并的最大工作线程数。 |
| [zone_merge_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945155) | 用于设置在合并时，支持多少个 Zone 并发。 |
| [zone_merge_order](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945156) | 用于设置 Zone 的轮转合并顺序。 |
| [zone_merge_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945157) | 用于设置单个 Zone 的合并超时时间。 |

### PX 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [px_workers_per_cpu_quota](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944384) | 用于设置并行执行工作线程数的比例。 |
| [px_task_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944383) | 用于设置 SQL 并行查询引擎每个任务处理的数据量大小。 |
| [max_px_worker_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944347) | 用于设置 SQL 并行查询引擎使用的最大线程数。 |

### 缓存相关

| 配置项名 | 功能描述 |
| --- | --- |
| [bf_cache_miss_count_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944944) | 用于控制 Bloomfilter Cache 的触发次数，当宏块未命中次数达到该值时，创建 Bloomfilter 缓存。 |
| [bf_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944945) | 用于设置 Bloom Filter 缓存优先级。 |
| [cache_wash_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944947) | 用于设置触发缓存清理的容量阈值。 |
| [fuse_row_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945014) | 用于设置融合行缓存在缓存系统中的优先级。 |
| [multiblock_read_gap_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944370) | 用于设置一次 IO 聚合读取块缓存的最大容量。 |
| [user_row_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945148) | 用于设置基线数据行缓存在缓存系统中的优先级。 |
| [user_tab_col_stat_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945149) | 用于设置统计数据缓存在缓存系统中的优先级。 |
| [index_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945024) | 用于设置索引在缓存系统中的优先级。 |
| [index_info_block_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945026) | 用于设置块索引在缓存系统中的优先级。 |
| [autoinc_cache_refresh_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946172) | 用于设置自增列缓存的刷新间隔。 |
| [plan_cache_evict_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944380) | 用于设置执行计划缓存的淘汰时间间隔。 |
| [enable_auto_refresh_location_cache](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944981) | 用于设置是否开启自动刷新位置缓存信息逻辑。 |
| [auto_refresh_location_cache_rate_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946169) | 用于设置每个 OBServer 每秒可触发自动刷新的最大分区数目。 |
| [auto_broadcast_location_cache_rate_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946161) | 用于设置每个 OBServer 每秒可广播的位置信息变化的分区的最大数量。 |
| [user_block_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945146) | 用于设置数据块缓存在缓存系统中的优先级。 |

### Location Cache 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [virtual_table_location_cache_expire_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945150) | 用于设置虚拟表的位置信息缓存过期时间。 |
| [location_cache_refresh_rpc_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944336) | 通过 RPC 刷新 `location_cache` 的超时时间。 |
| [location_cache_refresh_sql_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944337) | 通过 SQL 刷新 `location_cache` 的超时时间。 |
| [force_refresh_location_cache_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945011) | 用于设置刷新位置缓存的最大时间间隔。 |
| [force_refresh_location_cache_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945012) | 用于设置刷新位置缓存时每秒最多刷新次数的阈值，超过该阈值会被限流。 |
| [location_cache_priority](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944334) | 用于设置位置缓存在系统缓存服务中的优先级。 |
| [location_cache_refresh_min_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944335) | 用于设置位置缓存刷新请求的最小间隔，防止产生过多刷新请求造成系统压力过大。 |
| [location_cache_cpu_quota](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944332) | 用于设置位置缓存模块使用的 CPU 配额。 |
| [location_fetch_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944338) | 用于设置单机 location_cache 刷新的最大并发数。 |
| [location_cache_expire_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944333) | 用于设置分区位置缓存中分区位置信息的过期时长。不建议修改。 |
| [location_refresh_thread_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944339) | 用于设置 OBServer 从 RootService 中获取分区位置信息的线程数量。 |

### 日志相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_record_trace_log](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944995) | 用于设置是否记录追踪日志。 |
| [enable_async_syslog](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944979) | 用于设置是否启用系统日志异步写。 |
| [enable_syslog_recycle](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945004) | 用于设置是否开启回收系统日志的功能。 |
| [enable_syslog_wf](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945005) | 用于设置是否把 WARN 以上级别的系统日志打印到一个单独的日志文件中。 |
| [enable_separate_sys_clog](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944999) | 用于设置是否把系统事务日志与用户事务日志分开存储。 |
| [flush_log_at_trx_commit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945010) | 用于设置事务提交时写事务日志策略。 |
| [max_string_print_length](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944348) | 用于设置打印系统日志时，单行日志最大长度。 |
| [max_syslog_file_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944349) | 用于设置在回收日志文件之前可以容纳的日志文件数量。 |
| [syslog_level](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944426) | 用于设置系统日志级别。 |
| [trace_log_sampling_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945139) | 用于设置定期打印跟踪日志信息的时间。 |
| [ilog_index_expire_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945023) | 用于设置 OBServer 可提供的 Ilog 文件读取的时间上限。 |
| [diag_syslog_per_error_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945166) | 用于设置每个错误码每秒允许的 DIAG 系统日志数，超过该阈值后，日志将不再打印。 |

### 分区相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_pg](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944992) | 用于设置是否开启分区组功能。 |
| [partition_table_check_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944378) | 用于设置 OBServer 从分区表中删除不存在的副本的时间间隔。 |
| [partition_table_scan_batch_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944379) | 用于设置批量读取分区表信息的数量。 |
| [tablet_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945131) | 用于设置分区内部并行处理（合并、查询等）时每个分片的大小。 |

### 读写/查询相关

| 配置项名 | 功能描述 |
| --- | --- |
| [weak_read_version_refresh_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945152) | 用于设置弱一致性读版本号的刷新周期，影响弱一致性读数据的延时。 |
| [large_query_worker_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945029) | 用于设置预留给处理大查询的工作线程百分比。 |
| [large_query_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945028) | 用于设置查询执行时间的阈值。 |
| [trace_log_slow_query_watermark](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945140) | 用于设置查询的执行时间阈值，如果查询的执行时间超过该阈值，则被认为是慢查询，慢查询的追踪日志会被打印到系统日志中。 |

### RootService 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [auto_leader_switch_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946167) | 用于设置自动切主后台线程工作间隔时间。 |
| [rootservice_async_task_queue_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944392) | 用于设置 RootService 内部异步任务队列的大小。 |
| [rootservice_async_task_thread_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944393) | 用于设置 RootService 内部异步任务使用的线程池大小。 |
| [rootservice_list](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944394) | 用于显示 RootService 及其副本所在的机器列表。 |
| [rootservice_ready_check_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944396) | 用于设置 RootService 启动后等待和检查集群状态的时间间隔。 |
| [rootservice_memory_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944395) | 用于设置 RootService 的最大内存容量限制。 |
| [wait_leader_batch_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945151) | 用于设置 RootService 每次发送切主命令的最大分区个数。 |
| [enable_rootservice_standalone](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944998) | 用于设置是否让系统租户和 RootService 独占 OBServer 节点。 |
| [lease_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944331) | 用于设置心跳租约时长。 |
| [server_check_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944406) | 用于设置 Server 表一致性检查的时间间隔。 |
| [server_permanent_offline_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944411) | 用于设置节点心跳中断的时间阈值，即节点心跳中断多久后认为其被永久下线，永久下线的节点上的数据副本需要被自动补足。 |
| [ob_event_history_recycle_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944374) | 用于控制历史事件的回收间隔。 |

### 并发数相关

| 配置项名 | 功能描述 |
| --- | --- |
| [server_data_copy_in_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944409) | 用于设置单个节点迁入数据的最大并发数。 |
| [server_data_copy_out_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944410) | 用于设置单个节点迁出数据的最大并发数。 |
| [fast_recovery_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945009) | 用于控制 RootService 调度的快速恢复任务在 OBServer 上执行的并发数。 |
| [data_copy_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944961) | 用于设置系统中并发执行的数据迁移复制任务的最大并发数。 |
| [migrate_concurrency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944362) | 用于设置内部数据迁移的最大并发数。 |

### I/O 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [sys_bkgd_io_high_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944419) | 用于设置系统后台 IO 最高占用百分比。 |
| [sys_bkgd_io_low_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944420) | 用于设置系统后台 IO 最少占用的百分比。 |
| [syslog_io_bandwidth_limit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944425) | 用于设置系统日志所能占用的磁盘 IO 带宽上限，超过带宽上限容量的系统日志将被丢弃。 |
| [user_iort_up_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945147) | 用于设置用户磁盘 IO 时延阈值，即用户磁盘 IO 时延超过该阈值后，系统后台 IO 任务将被限流。 |
| [disk_io_thread_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944975) | 用于设置磁盘 IO 线程数。必须为偶数。 |
| [multiblock_read_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944371) | 用于设置读取数据时 IO 聚合大小。 |
| [net_thread_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944373) | 用于设置网络 I/O 线程数。 |

### TCP 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_tcp_keepalive](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945006) | 用于开启或关闭客户端连接的探活机制。 |
| [tcp_keepidle](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945133) | 用于设置客户端连接上服务器后，如果没有数据发送，多久后会发送 Keepalive 探测分组，单位为秒。 |
| [tcp_keepintvl](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945134) | 用于设置开启客户端连接的探活机制后，前后两次探测之间的时间间隔，单位为秒。 |
| [tcp_keepcnt](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945132) | 用于设置关闭一个非活跃连接之前的最大重试次数。 |

### RPC 安全相关

| 配置项名 | 功能描述 |
| --- | --- |
| [rpc_client_authentication_method](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-0000000001282475) | 用于设置 RPC 客户端的安全认证方式。 |
| [rpc_server_authentication_method](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-0000000001282476) | 用于设置 RPC 服务端的安全认证方式。 |

### 其他

| 配置项名 | 功能描述 |
| --- | --- |
| [all_cluster_list](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946158) | 用于显示访问相同 config_url 的服务器列表。 |
| [builtin_db_data_verify_cycle](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944946) | 用于设置数据坏块自检周期，单位为天。当值为 0 时表示不检查。 |
| [data_storage_warning_tolerance_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944965) | 用于控制数据盘状态设为 WARNING 状态的容忍时间。 |
| [dead_socket_detection_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944968) | 用于设置检测失效 Socket 的时间间隔。 |
| [internal_sql_execute_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945027) | 用于设置系统内部 DML 请求的时间间隔。 |
| [migration_disable_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944363) | 用于设置因磁盘满等原因导致某个节点数据迁入失败时的暂停迁入时长。 |
| [schema_history_expire_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944401) | 用于设置元数据历史数据过期时间。 |
| [ofs_list](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944377) | 保存了每个 Zone 的 OFS（OceanBase File System，OceanBase 数据库自主设计的分布式存储系统）连接 URL，主要用于在 OFS 部署模式下，RootService 跨 Zone 访问文件的需求。 |
| [datafile_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944967) | 用于设置数据文件的大小。一般不需要设置。 |
| [devname](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944974) | 用于设置服务进程绑定的网卡设备名。 |
| [enable_perf_event](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944991) | 用于设置是否开启性能事件的信息收集功能。 |
| [enable_record_trace_id](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944994) | 用于设置是否记录应用端设置的追踪 ID。 |
| [enable_upgrade_mode](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945008) | 用于设置是否开启升级模式。在升级模式中，会暂停部分系统后台功能。 |
| [enable_ddl](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944982) | 用于设置是否允许执行 DDL。 |
| [high_priority_net_thread_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945020) | 用于设置高优先级网络线程数，值为 `0` 时，表示关闭该功能。 |
| [mysql_port](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944372) | 用于设置 SQL 服务协议端口号。 |
| [obconfig_url](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944376) | 用于设置 OBConfig 服务的 URL 地址。 |
| [rpc_port](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944399) | 用于设置远程访问的协议端口号。 |
| [ssl_client_authentication](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944415) | 用于设置是否开启 SSL 连接功能。 |
| [stack_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944417) | 用于设置程序函数调用栈的大小。 |
| [tenant_task_queue_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945137) | 用于设置每个租户的请求队列大小。 |
| [zone](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945154) | 用于设置节点所在的 Zone 的名字。该配置项一般不需要配置。 |
| [ssl_external_kms_info](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944416) | 用于记录 OceanBase 数据库 SSL 功能运行依赖的一些信息，通过 json 字符串方式记录不同 SSL 使用方式下依赖的相关配置，json 中至少包含类型 `ssl_mode` 字段。 |
| [recyclebin_object_expire_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944386) | 用于自动 Purge 回收站中过期的 Schema 对象。 |
| [default_row_format](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944972) | 用于设置在 MySQL 模式下，建表时使用的默认行格式。 |
| [enable_election_group](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944983) | 用于设置是否打开选举组策略。 |
| [enable_sql_audit](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945001) | 用于设置是否开启 SQL 审计功能。 |
| [min_observer_version](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944364) | 用于设置本集群最低的 OBServer 应用程序版本号。 |
| [sys_bkgd_net_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944423) | 用于设置后台系统任务可占用网络带宽百分比。 |
| [schema_history_recycle_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944402) | 用于设置系统内部执行 `schema` 多版本记录回收任务的时间间隔。 |

### 暂不支持的配置项

| 配置项名 | 功能描述 |
| --- | --- |
| [all_cluster_list](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000946158) | 用于显示访问相同 config_url 的服务器列表。 |
| [enable_unit_balance_resource_weight](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945007) | 用于设置是否开启手动配置资源权重的功能。 |
| [plan_cache_high_watermark](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944381) | 用于设置执行计划缓存占用内存的阈值，如果超过该阈值时将触发自动淘汰。 |
| [plan_cache_low_watermark](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944382) | 用于设置执行计划缓存占用内存的阈值，如果低于该阈值时将停止淘汰。 |
| [server_temporary_offline_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944412) | 用于设置节点心跳中断的时间阈值，即节点心跳中断多久后认为其被临时下线。 |
| [sql_audit_queue_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944414) | 用于设置 SQL 审计数据存储的最大记录条数。 |
| [tenant_cpu_variation_per_server](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945135) | 用于设置租户多个 Unit 之间 CPU 配额调度允许的偏差。 |
| [system_trace_level](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944429) | 用于设置系统追踪日志的日志打印级别。 |

## 租户级配置项

### 分区相关

| 配置项名 | 功能描述 |
| --- | --- |
| [max_partition_num](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-1000000001886188) | 用于控制 MySQL 模式下允许的最大分区数。 |

### 内存相关

| 配置项名 | 功能描述 |
| --- | --- |
| [range_optimizer_max_mem_size](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-1000000001559600) | 用于限制 Query Range 模块使用的内存。 |

### 用户登录相关

#### 说明

下表中的配置项当前仅在 MySQL 模式下生效。

| 配置项名 | 功能描述 |
| --- | --- |
| [connection_control_failed_connections_threshold](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945171) | 用来指定用户错误登录尝试的阀值。 |
| [connection_control_min_connection_delay](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945172) | 指定了超过错误登录次数阈值之后，错误登录锁定的最小时长。 |
| [connection_control_max_connection_delay](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945173) | 指定了错误登录锁定时长的最大值，当时长达到这个最大值之后就不再增长。 |

### 审计相关

| 配置项名 | 功能描述 |
| --- | --- |
| [audit_sys_operations](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945167) | 用于设置是否追踪系统用户的操作行为。 |
| [audit_trail](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945168) | 用于设置是否启用数据库审核。 |

### 事务及事务日志相关

| 配置项名 | 功能描述 |
| --- | --- |
| [writing_throttling_maximum_duration](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945194) | 通过控制内存分配进度，控制写入速度。即指定在触发写入限速后，剩余 MemStore 内存分配完所需的时间。 |
| [writing_throttling_trigger_percentage](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945195) | 用于设置写入速度的阈值。 |
| [clog_persistence_compress_func](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945170) | 用于设置事务日志落盘压缩算法。 |
| [clog_max_unconfirmed_log_count](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945169) | 用于设置事务模块中未确认日志的最大数量。 |
| [enable_clog_persistence_compress](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945175) | 用于设置是否开启事务日志落盘压缩。 |

### 转储与合并相关

| 配置项名 | 功能描述 |
| --- | --- |
| [default_progressive_merge_num](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945174) | 用于设置新建一张表时默认的渐进合并次数。 |

### 加密相关

| 配置项名 | 功能描述 |
| --- | --- |
| [external_kms_info](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945178) | 用于存储一些密钥管理信息。 |
| [tde_method](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945193) | 用于设置透明表空间加密的方式。 |

### PL

| 配置项名 | 功能描述 |
| --- | --- |
| [plsql_ccflags](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945186) | 用于定义 PL 编译器的编译常量。 |
| [plsql_code_type](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945187) | 用于指定 PL/SQL 代码的编译类型。 |
| [plsql_debug](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945188) | 用于指定是否编译成 debug 版本。 |
| [plsql_optimize_level](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945189) | 用于指定编译优化级别。 |
| [plsql_v2_compatibility](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945190) | 用于指定 Oracle 8 的兼容功能。   **说明**    该配置项仅适用于 Oracle 模式，当前暂不生效。 |
| [plsql_warnings](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945191) | 用于控制 PL/SQL 编译器的报错行为，可以指定某类型或某个 `warning` 码的状态为`enable`、`disable` 或 `error`。 |

### 兼容相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_sql_extension](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945179) | 用于设置是否开启租户的 SQL 扩展功能。 |

### 读写/查询相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_monotonic_weak_read](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945177) | 用于设置是否开启单调读。 |
| [max_stale_time_for_weak_consistency](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945181) | 用于设置弱一致性读允许读到多旧的数据。 |

### 路由相关

| 配置项名 | 功能描述 |
| --- | --- |
| [ob_proxy_readonly_transaction_routing_policy](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945183) | 用于控制 Proxy 对于事务的路由是否受只读语句的影响。 |

### TTL 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [kv_ttl_history_recycle_interval](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-1000000000364076) | 用于限制 TTL 任务历史记录保存的时间段。 |
| [kv_ttl_duty_duration](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-1000000000364077) | 用于限制 TTL 后台任务的运行时间段。 |
| [enable_kv_ttl](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-1000000000364078) | 用于控制是否启用 TTL 后台任务。 |

### 其他

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_early_lock_release](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945176) | 用于设置是否开启提前解行锁的功能。 |
| [workarea_size_policy](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945196) | 用于设置手动或者自动调整 SQL 工作区大小的策略。 |
| [open_cursors](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945185) | 用于限制单个 Session 可以同时打开的游标数量。 |
| [ob_ssl_invited_common_names](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945184) | 用于记录当前租户运行的应用身份列表，该身份来自 SSL 双向认证中 Client 端证书 `subject` 中的 `cn` 字段（common name）。 |
| [ob_enable_batched_multi_statement](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945182) | 用于设置是否启用批处理功能的成组执行优化。 |
| [job_queue_processes](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945180) | 用来设定每个租户上可以同时运行的任务数上限，目的是为了控制任务挤占租户的资源。   **说明**    该配置项当前仅在 Oracle 模式下生效。 |
| [ob_query_switch_leader_retry_timeout](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945197) | 用于设置失败 Query 的最大重试时间，单位为微秒（us）。 |

### 暂不支持的配置项

| 配置项名 | 功能描述 |
| --- | --- |
| [sql_work_area](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000945192) | 用于设置租户的工作区内存。 |

 上一篇 下一篇 ![有帮助](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) 咨询热线