---
title: "配置项总览 - OceanBase AI 数据库 V4.6.3 | OceanBase 文档中心"
description: 配置项总览 本文根据配置项的功能，详细地罗列了 OceanBase AI 数据库的集群级配置项和租户级配置项。 集群级配置项 安全相关 配置项名 功能描述 mysql_port 用于设置 SQL 服务协议端口号。 rpc_port 用于设置远程访问的协议端口号。 sql_protocol_min_tls_versio…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*M1BcQZvbrRMAAAAAQGAAAAgAeiGDAQ/original) OceanBase AI 数据库V 4.6.3

# 配置项总览

更新时间：2026-10-29 17:22:34

[编辑](https://github.com/oceanbase/oceanbase-database-ai/edit/V4.6.3/zh-CN/700.reference/800.configuration-items-and-system-variables/100.system-configuration-items/200.system-configuration-items-overview-list.md)  

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

## 集群级配置项

### 安全相关

| 配置项名 | 功能描述 |
| --- | --- |
| [mysql_port](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090824) | 用于设置 SQL 服务协议端口号。 |
| [rpc_port](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090896) | 用于设置远程访问的协议端口号。 |
| [sql_protocol_min_tls_version](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090934) | 用于设置 SQL 语句进行 SSL 连接时所使用的 SSL/TLS 协议的最低版本号。 |
| [ssl_client_authentication](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090922) | 用于设置是否开启 SSL 连接功能。 |
| [ssl_external_kms_info](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090948) | 用于记录 OceanBase AI 数据库SSL 功能运行依赖的一些信息，通过 json 字符串方式记录不同 SSL 使用方式下依赖的相关配置，json 中至少包含类型 `ssl_mode` 字段。 |
| [enable_sql_audit](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090860) | 用于设置是否开启 SQL 审计功能。 |

### cgroup 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_cgroup](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090912) | 用于控制 OBServer 节点是否开启 cgroup 功能。 |

### CPU 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [cpu_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090862) | 用于设置系统 CPU 总数。如果设置为 0，系统将自动检测 CPU 数量。 |
| [server_balance_cpu_mem_tolerance_percent](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090984) | 在节点负载均衡策略中，用于设置 CPU 和内存资源不均衡的容忍度。 |
| [server_cpu_quota_max](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090863) | 用于设置系统可以使用的最大 CPU 配额。 |
| [server_cpu_quota_min](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090978) | 用于设置系统可以使用的最小 CPU 配额，系统会自动预留。 |
| [workers_per_cpu_quota](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090852) | 用于设置分配给每个 CPU 配额的工作线程数量。 |

### 读写/查询相关

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

### 负载均衡相关

| 配置项名 | 功能描述 |
| --- | --- |
| [balancer_log_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090887) | 用于设置容灾任务线程打印统计日志的间隔时间。 |
| [balancer_task_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090929) | 用于设置负载均衡等后台任务的超时时间。 |
| [balancer_tolerance_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090972) | 用于设置负载均衡策略中，租户内多个 Unit 间磁盘不均衡程度的宽容度，如果在均值 + 或 - 宽容度范围之内，不会触发执行均衡动作。 |
| [server_balance_critical_disk_waterlevel](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090976) | 用于设置磁盘空间的负载均衡功能的水位线。 |
| [server_balance_disk_tolerance_percent](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090877) | 用于设置节点间磁盘负载均衡策略中不均衡程度的容忍度。 |
| [resource_hard_limit](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090961) | 用于定义 CPU 资源的超卖百分比。 |
| [enable_sys_unit_standalone](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090854) | 用于设置系统租户的 Unit 是否独占节点。 |

### 副本相关

| 配置项名 | 功能描述 |
| --- | --- |
| [unit_gc_wait_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090977) | 指定 Unit GC 的最大等待时长，超过最大等待时长则强制 GC。 |
| [enable_rereplication](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090870) | 日志流副本自动迁移复制的总开关。 |
| [ls_meta_table_check_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090881) | 用于设置 DBA_OB_LS_LOCATIONS/CDB_OB_LS_LOCATIONS 视图的后台巡检线程的检查间隔。 |
| [sys_bkgd_migration_change_member_list_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090831) | 用于设置副本迁移时变更 Paxos 成员组操作的超时时间。 |
| [sys_bkgd_migration_retry_num](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090958) | 用于设置副本迁移失败时最多重试次数。 |

### 缓存相关

| 配置项名 | 功能描述 |
| --- | --- |
| [bf_cache_miss_count_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090888) | 用于控制 Bloomfilter Cache 的触发次数，当宏块未命中次数达到该值时，创建 Bloomfilter 缓存。 |
| [bf_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090895) | 用于设置 Bloom Filter 缓存优先级。 |
| [cache_wash_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090918) | 用于设置触发缓存清理的容量阈值。 |
| [fuse_row_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090931) | 用于设置融合行缓存在缓存系统中的优先级。 |
| [user_row_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090937) | 用于设置基线数据行缓存在缓存系统中的优先级。 |
| [autoinc_cache_refresh_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090837) | 用于设置自增列缓存的刷新间隔。 |
| [plan_cache_evict_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090843) | 用于设置执行计划缓存的淘汰时间间隔。 |
| [index_block_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090914) | 用于设置元数据索引微块缓存优先级。 |
| [opt_tab_stat_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090817) | 用于设置统计信息缓存优先级。 |
| [tablet_ls_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090849) | 用于设置 Tablet 映射缓存优先级。 |
| [user_block_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090840) | 用于设置数据块缓存在缓存系统中的优先级。 |

### 分区相关

| 配置项名 | 功能描述 |
| --- | --- |
| [tablet_meta_table_check_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090979) | 用于设置 DBA_OB_TABLET_REPLICAS/CDB_OB_TABLET_REPLICAS 视图的后台巡检线程的检查间隔。 |
| [tablet_meta_table_scan_batch_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090904) | 用于设置 Tablet meta table 迭代器使用过程中在内存里缓存的 Tablet 数量。 |
| [tablet_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090915) | 用于设置分区内部并行处理（合并、查询等）时每个分片的大小。 |

### 后台执行线程相关

| 配置项名 | 功能描述 |
| --- | --- |
| [sql_net_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090875) | 用于设置集群 IO 线程的个数，即 `global_sql_nio_server` 线程的个数。默认值为 0 表示与配置项 `net_thread_count` 的值相同。 |

### IO 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [sync_io_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090819) | 配置同步 IO 请求的线程数。 |
| [syslog_io_bandwidth_limit](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090829) | 用于设置系统日志所能占用的磁盘 IO 带宽上限，超过带宽上限容量的系统日志将被丢弃。 |
| [disk_io_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090901) | 用于设置磁盘 IO 线程数。必须为偶数。 |
| [net_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090953) | 用于设置网络 I/O 线程数。 |
| [data_storage_error_tolerance_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090865) | 用于控制数据盘状态设为 `ERROR` 状态的容忍时间。 |

### 集群相关

| 配置项名 | 功能描述 |
| --- | --- |
| [all_server_list](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090963) | 用于显示群集中的所有服务器地址。 |
| [cluster](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090908) | 用于设置本 OceanBase AI 数据库集群名。 |
| [cluster_id](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090974) | 用于设置本 OceanBase AI 数据库集群 ID。 |
| [rpc_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090846) | 用于设置集群内部请求的超时时间。 |
| [all_cluster_list](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090832) | 用于显示访问相同 config_url 的服务器列表。 |
| [local_ip](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090830) | 用于安装 ObServer 机器的 IP 地址。 |
| [observer_id](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090947) | 用于集群中 RS 分配给 OBServer 节点的唯一标识。 |
| [min_observer_version](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090842) | 用于查看本集群最低的 OBServer 节点应用程序版本号。 |

### 带宽相关

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

### Location Cache 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [virtual_table_location_cache_expire_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090927) | 用于设置虚拟表的位置信息缓存过期时间。 |
| [location_cache_refresh_rpc_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090897) | 通过 RPC 刷新 `location_cache` 的超时时间。 |
| [location_cache_refresh_sql_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090960) | 通过 SQL 刷新 `location_cache` 的超时时间。 |
| [location_cache_refresh_min_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090982) | 用于设置位置缓存刷新请求的最小间隔，防止产生过多刷新请求造成系统压力过大。 |
| [location_cache_cpu_quota](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090845) | 用于设置位置缓存模块使用的 CPU 配额。 |
| [location_fetch_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090905) | 用于设置单机 location_cache 刷新的最大并发数。 |
| [location_refresh_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090816) | 用于设置 OBServer 节点从 Root Service 中获取分区位置信息的线程数量。 |

### 目录路径相关

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

### 内存空间相关

| 配置项名 | 功能描述 |
| --- | --- |
| [datafile_disk_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090957) | 表示占用 data_dir 所在磁盘（磁盘 data_dir 所在磁盘将被 OceanBase AI 数据库系统初始化用于存储数据）总空间的百分比。 |
| [data_disk_usage_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090841) | 用于设置数据文件最大可以写入的百分比，超过这个阈值后，禁止数据迁入。 |
| [enable_sql_operator_dump](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090910) | 用于设置是否允许 SQL 处理过程的中间结果写入磁盘以释放内存。 |
| [leak_mod_to_check](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090973) | 用于内存泄露检查，是属于内部调试的功能。 |
| [memory_chunk_cache_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090858) | 用于设置内存分配器缓存的内存块容量。 |
| [memory_limit](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090855) | 表示可用的总内存大小。 |
| [memory_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090827) | 用于设置系统总可用内存大小占总内存大小的百分比。 |
| [memory_reserved](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090882) | 用于设置系统底层模块预留的内存容量大小。 |
| [memstore_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090949) | 用于设置租户使用 MemStore 的内存占其总可用内存的百分比。 |
| [system_memory](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090935) | 用于设置系统预留给租户 ID 为 `500` 的租户的内存容量。 |
| [use_large_pages](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090951) | 用于管理数据库使用的内存大页。 |
| [datafile_maxsize](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090983) | 用于设置磁盘文件自动扩容的空间最大值。 |
| [datafile_next](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090980) | 用于设置磁盘文件自动扩容的增长步长。 |
| [storage_meta_cache_priority](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090880) | 用于控制 kvcache 中存储 Meta Cache 的优先级。 |

### PX 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [px_task_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090861) | 用于设置 SQL 并行查询引擎每个任务处理的数据量大小。 |

### 其他

| 配置项名 | 功能描述 |
| --- | --- |
| [builtin_db_data_verify_cycle](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090879) | 用于设置数据坏块自检周期，单位为天。当值为 0 时表示不检查。 |
| [data_storage_warning_tolerance_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090820) | 用于控制数据盘状态设为 WARNING 状态的容忍时间。 |
| [dead_socket_detection_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090955) | 用于设置检测失效 Socket 的时间间隔。 |
| [migration_disable_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090939) | 用于设置因磁盘满等原因导致某个节点数据迁入失败时的暂停迁入时长。 |
| [schema_history_expire_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090818) | 用于设置元数据历史数据过期时间。 |
| [datafile_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090954) | 用于设置数据文件的大小。一般不需要设置。 |
| [devname](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090838) | 用于设置服务进程绑定的网卡设备名。 |
| [enable_perf_event](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090985) | 用于设置是否开启性能事件的信息收集功能。 |
| [enable_record_trace_id](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090872) | 用于设置是否记录应用端设置的追踪 ID。 |
| [enable_upgrade_mode](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090920) | 用于设置是否开启升级模式。在升级模式中，会暂停部分系统后台功能。 |
| [enable_ddl](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090925) | 用于设置是否允许执行 DDL。 |
| [high_priority_net_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090968) | 用于设置高优先级网络线程数，值为 `0` 时，表示关闭该功能。 |
| [obconfig_url](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090857) | 用于设置 OBConfig 服务的 URL 地址。 |
| [rpc_port](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090896) | 用于设置远程访问的协议端口号。 |
| [stack_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090903) | 用于设置程序函数调用栈的大小。 |
| [tenant_task_queue_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090868) | 用于设置每个租户的请求队列大小。 |
| [zone](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090825) | 用于设置节点所在的 Zone 的名字。该配置项一般不需要配置。 |
| [recyclebin_object_expire_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090850) | 用于自动 Purge 回收站中过期的 Schema 对象。 |
| [default_row_format](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090945) | 用于设置建表时使用的默认行格式。 |
| [sys_bkgd_net_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090864) | 用于设置后台系统任务可占用网络带宽百分比。 |
| [schema_history_recycle_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090883) | 用于设置系统内部执行 `schema` 多版本记录回收任务的时间间隔。 |
| [enable_asan_for_memory_context](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090847) | 在使用 ob_asan 时，用于设置是否允许 ObAsanAllocator（默认 ObAllocator 作为 MemoryContext 的分配器）。 |
| [async_ps_cursor_max_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090814) | 用于控制单节点中异步 PS cursor 的最大个数。 |

### 日志服务相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_logservice](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090981) | 用于控制日志服务模式的开关。 |
| [logservice_access_point](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090885) | 用于持久化日志服务访问点。 |
| [sys_ckpt_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007109263) | 用于设置集群级 LS checkpoint 工作线程分值，控制 LS checkpoint 调度队列的任务并发额度，以及首次创建集群时 Bootstrap checkpoint 的上传并发度。 |

### Root Service 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [rootservice_async_task_queue_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090833) | 用于设置 Root Service 内部异步任务队列的大小。 |
| [rootservice_async_task_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090970) | 用于设置 Root Service 内部异步任务使用的线程池大小。 |
| [rootservice_list](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090839) | 用于显示 Root Service 及其副本所在的机器列表。 |
| [rootservice_ready_check_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090975) | 用于设置 Root Service 启动后等待和检查集群状态的时间间隔。 |
| [lease_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090952) | 用于设置心跳租约时长。 |
| [server_check_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090822) | 用于设置 Server 表一致性检查的时间间隔。 |
| [server_permanent_offline_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090942) | 用于设置节点心跳中断的时间阈值，即节点心跳中断多久后认为其被永久下线，永久下线的节点上的数据副本需要被自动补足。 |
| [ob_event_history_recycle_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090823) | 用于控制历史事件的回收间隔。 |

### RPC 认证相关

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

### SQL 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [sql_login_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090836) | 用于设置处理 SQL 登录请求的线程数量。 |
| [enable_sys_table_ddl](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090928) | 用于指定是否允许手动创建系统表。 |
| [internal_sql_execute_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090950) | 用于设置系统内部 DML 请求的时间间隔。 |

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

| 配置项名 | 功能描述 |
| --- | --- |
| [log_disk_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090967) | 用于设置 Redo 日志磁盘的大小。 |
| [log_disk_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090886) | 用于设置 Redo 日志占用其所在磁盘总空间的百分比。 |
| [dtl_buffer_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090900) | 用于设置 SQL 数据传输模块使用的缓存大小。 |
| [ignore_replay_checksum_error](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090873) | 用于设置是否忽略回放事务日志时发生的校验和错误。 |
| [trx_2pc_retry_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090962) | 用于设置两阶段提交失败时候自动重试的时间间隔。 |
| [standby_fetch_log_bandwidth_limit](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090834) | 用于设置备租户所在集群中的所有 Server 从主租户同步日志的流量总和每秒可占用的最大带宽。 |
| [log_storage_warning_tolerance_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090890) | 用于设置从日志盘 IO 失败到磁盘被标记为坏盘时触发切主的时间。 |
| [clog_sync_time_warn_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090924) | 用于设置事务日志同步耗时告警阈值，同步耗时超过该值产生 WARN 日志。 |
| [ignore_replay_checksum_error](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090873) | 用于设置是否忽略回放事务日志时发生的校验和错误。 |

### 调试相关

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

### TCP 相关

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

### 系统日志相关

| 配置项名 | 功能描述 |
| --- | --- |
| [alert_log_level](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090940) | 用于设置告警日志的级别。 |
| [enable_record_trace_log](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090965) | 用于设置是否记录追踪日志。 |
| [enable_async_syslog](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090938) | 用于设置是否启用系统日志异步写。 |
| [enable_syslog_recycle](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090821) | 用于设置是否打开记录 OBServer 节点启动前的旧日志的开关，与 `max_syslog_file_count` 配合使用，决定回收逻辑是否考虑旧的日志文件。 |
| [enable_syslog_wf](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090966) | 用于设置是否把 WARN 以上级别的系统日志打印到一个单独的日志文件中。 |
| [max_string_print_length](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090956) | 用于设置打印系统日志时，单行日志最大长度。 |
| [max_syslog_file_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090943) | 用于设置在回收日志文件之前可以容纳的日志文件数量。 |
| [syslog_level](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090902) | 用于设置系统日志级别。 |
| [diag_syslog_per_error_limit](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090892) | 用于设置每个错误码每秒允许的 DIAG 系统日志数，超过该阈值后，日志将不再打印。 |

### 压缩算法相关

| 配置项名 | 功能描述 |
| --- | --- |
| [default_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090906) | 用于设置表数据的默认压缩算法，也可以在建表的时候指定其他压缩算法。 |
| [kv_transport_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090933) | 用于设置 OBKV-Table 查询结果传输使用的压缩算法。 |

### 转储与合并相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_major_freeze](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090813) | 用于设置是否开启自动全局冻结的功能。 |
| [micro_block_merge_verify_level](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090944) | 用于设置合并时宏块的校验级别。 |
| [row_compaction_update_limit](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090964) | 用于设置触发内存中行内数据合并的修改次数。 |

### 资源隔离相关

| 配置项名 | 功能描述 |
| --- | --- |
| [clog_io_isolation_mode](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090867) | 用于根据 clog 盘和 data 盘是否独立，来决定 clog 盘的 I/O 请求是否受资源隔离的管控。 |
| [enable_global_background_resource_isolation](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090844) | 用于开启全局前后台资源隔离功能。 |
| [global_background_cpu_quota](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090848) | 用于控制在开启全局前后台资源隔离时后台任务的 CPU 配额。 |

## 租户级配置项

### 安全相关

| 配置项名 | 功能描述 |
| --- | --- |
| [sts_credential](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090761) | 用于指定访问 OCP 提供的 STS 服务的凭证。 |
| [external_kms_info](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090770) | 用于存储一些密钥管理信息。 |
| [tde_method](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090800) | 用于设置透明表空间加密的方式。 |
| [audit_sys_operations](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090690) | 用于设置是否追踪系统用户的操作行为。 |
| [audit_trail](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090654) | 用于设置是否启用数据库审核。 |

### 存储相关

| 配置项名 | 功能描述 |
| --- | --- |
| [default_table_organization](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090640) | 用于指定默认创建表的表组织模式。 |
| [default_table_merge_engine](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090664) | 用于指定用户租户默认创建表的 `merge_engine`。 |
| [default_delta_format](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090702) | 用于设置创建表时默认的增量数据存储格式。 |

### CPU 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [cpu_quota_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090760) | 用于设置租户的每个 CPU 配额所允许的最大并发数。 |

### 读写/查询相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_monotonic_weak_read](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090744) | 用于设置是否开启单调读。 |
| [query_response_time_stats](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090726) | 用于设置是否启用 `information_schema.QUERY_RESPONSE_TIME` 视图的统计信息收集。 |
| [query_response_time_flush](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090675) | 用于设置是否刷新 `information_schema.QUERY_RESPONSE_TIME` 视图并重新读取 `query_response_time_range_base`。 |
| [query_response_time_range_base](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090634) | 用于设置 `information_schema.QUERY_RESPONSE_TIME` 视图收集时间参数的间隔时间。 |

### 负载均衡相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_ls_leader_balance](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090630) | 用于控制是否开启日志流 Leader 的自动均衡。 |
| [enable_gts_standalone](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090790) | 用于设置是否开启租户 GTS 服务独占一组 Unit 的功能。 |
| [balancer_idle_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090779) | 用于设置负载均衡等后台任务线程空闲时的唤醒间隔时间。 |
| [enable_rebalance](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090794) | 用于设置是否开启自动负载均衡的功能。 |
| [enable_transfer](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090733) | 用于控制是否允许在租户内进行 Transfer。关闭配置项 `enable_rebalance` 时此配置项无效。 |
| [partition_balance_schedule_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090713) | 用于分区均衡调度周期。 |
| [enable_database_sharding_none](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090730) | 用于控制创建 DataBase 时用户表是否开启自动聚合的开关。 |

### 副本相关

| 配置项名 | 功能描述 |
| --- | --- |
| [replica_parallel_migration_mode](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090704) | 用于指定日志流副本并行迁移功能的模式。 |
| [choose_migration_source_policy](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090727) | 用于指定迁移选择源端副本的优先策略。 |

### 扩缩容相关

| 配置项名 | 功能描述 |
| --- | --- |
| [ls_scale_out_factor](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090728) | 日志流的扩容系数，用于控制租户在每台服务节点上日志流的个数。 |

### 备份恢复相关

| 配置项名 | 功能描述 |
| --- | --- |
| [recover_table_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090777) | 设置表级恢复的跨租户导表阶段，多表允许并行恢复的最大表数。 |
| [recover_table_dop](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090810) | 设置表级恢复的跨租户导表阶段，单表允许并行恢复的最大表数。 |
| [log_restore_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090670) | 用于设置恢复日志的并发度。 |
| [log_archive_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090647) | 用于设置日志归档的并发度。 |
| [backup_data_file_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090659) | 用于控制单个数据备份文件的文件大小上限。 |

### 分区相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_auto_split](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090785) | 用于控制租户是否开启自动分区功能。 |
| [auto_split_tablet_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090687) | 用于控制这个租户开启自动分区功能之后触发分裂的阈值。 |
| [global_index_auto_split_policy](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090636) | 用于控制新建的全局索引是否开启自动分区功能，默认值 `DISTRIBUTED`。 |

### 后台执行线程相关

| 配置项名 | 功能描述 |
| --- | --- |
| [px_workers_per_cpu_quota](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090766) | 用于设置并行执行工作线程数的比例。 |
| [attach_shared_sstable_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090712) | 用于配置租户可用来计算节点共享数据引用的线程数。 |
| [inc_sstable_upload_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090694) | 用于配置租户可用来计算数据共享类任务的线程数。 |
| [shared_gc_executor_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090643) | 用于配置同时可用来执行共享数据 GC 任务的线程数。 |
| [shared_gc_generator_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090651) | 用于配置同时可用来生成共享数据 GC 任务的线程数。 |
| [ddl_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090739) | 用于设置 DDL 任务使用的线程数。 |
| [compaction_low_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090798) | 用于设置低优先级 compaction 的工作线程数。 |
| [compaction_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090637) | 用于设置高优先级 compaction 的工作线程数。 |
| [compaction_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090678) | 用于设置中优先级 compaction 的工作线程数。 |
| [ha_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090722) | 用于设置高可用高优先级线程的当前工作线程数。 |
| [ha_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090635) | 用于设置高可用中优先级线程的当前工作线程数。 |
| [ha_low_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090748) | 用于设置高可用低优先级线程的当前工作线程数。 |
| [ob_compaction_schedule_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090710) | 用于设置 Compaction 调度的时间间隔。 |
| [compaction_dag_cnt_limit](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090786) | 用于配置 Compaction DAG 队列上 DAG 数量的上限值。 |
| [compaction_schedule_tablet_batch_cnt](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090718) | 用于配置 Compaction 分批调度时，每个批次调度的分区数的上限值。 |
| [tenant_sql_login_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090669) | 用于设置用户租户登录的线程个数，即 `mysql_queue` 线程的个数，默认值为 0 表示取 `unit_min_cpu` 的值。 |
| [tenant_sql_net_thread_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090765) | 用于设置用户租户 IO 线程的个数，即 `sql_nio_server` 线程的个数，默认值为 0 表示取 `unit_min_cpu` 的值。 |
| [ddl_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090711) | 用于修改执行 ddl kv merge 的 DAG 线程数。 |

### 缓存相关

| 配置项名 | 功能描述 |
| --- | --- |
| [default_storage_cache_policy](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090723) | 用于配置默认的缓存策略。 |
| [enable_manual_storage_cache_policy](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090749) | 用于启用用户手动指定的热点缓存策略。 |
| [suspend_storage_cache_task](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090759) | 用于设置是否暂停后台缓存任务。 |
| [enable_adaptive_plan_cache](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090745) | 用于控制租户是否开启计划缓存（Plan Cache）自适应的能力。 |
| [result_cache_max_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090676) | 用于控制 `result cache` 模块能使用的最大内存量。 |
| [result_cache_max_result](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090680) | 用于控制单个 `result cache` 缓存对象最多能使用 `result_cache_max_size` 的内存比例。 |
| [ob_result_cache_evict_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090655) | 用于设置 `result cache` 内存淘汰水位线。 |
| [ob_deterministic_udf_cache_max_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090775) | 用于标记语句执行期，所有 `deterministic` 的 UDF 的缓存池总共可以使用的最大内存量。 |

### 兼容相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_sql_extension](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090769) | 用于设置是否开启租户的 SQL 扩展功能。 |
| [compatible](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090791) | 用于控制租户下相关功能的兼容行为，此配置项不可设置。 |

### 路由相关

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

### LOB 数据相关

| 配置项名 | 功能描述 |
| --- | --- |
| [lob_enable_block_cache_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090764) | 用于设置 OUTROW 存储的 LOB 查询缓存的阈值。 |

### 内存空间相关

| 配置项名 | 功能描述 |
| --- | --- |
| [ob_vector_memory_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090797) | 用于配置向量索引模块对内存资源占用的阈值（单位为百分比）。 |
| [range_optimizer_max_mem_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090707) | 用于限制 Query Range 模块使用的内存。 |
| [rpc_memory_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090780) | 用于设置租户中 RPC 的最大内存，占租户总内存的百分比。 |
| [query_memory_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090688) | 用于指定单条 SQL 可使用的租户内存百分比。 |

### 磁盘空间相关

| 配置项名 | 功能描述 |
| --- | --- |
| [temporary_file_max_disk_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090639) | 设置租户的单个节点内临时文件最大可占用的磁盘空间大小。 |

### OBKV 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_kv_ttl](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090661) | 用于控制是否启动 TTL 后台任务，该配置项对周期性 TTL 任务有效，用户管控命令不受此配置项限制。**注意**:过期数据删除（TTL）功能仅限于 OceanBase KV 场景使用，SQL 场景下禁用，否则会导致不可预期的数据误删除问题。 |
| [kv_ttl_duty_duration](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090801) | 于设置每日定时 TTL 的触发时段，TTL 任务会在该时间段内触发一次。 |
| [kv_group_commit_batch_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090703) | 用于指定 OBKV 组提交中执行 batch 操作的大小。 |
| [kv_group_commit_rw_mode](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090684) | 用于在控制走组提交的场景。 |
| [kv_hbase_client_scanner_timeout_period](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090638) | 用于设置 OBKV-HBase 流式查询超时时间。 |
| [kv_ttl_history_recycle_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090771) | 用于设置 TTL 任务历史记录保存的时间段。 |
| [ttl_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090700) | 用于设置 TTL 任务使用的工作线程数。 |
| [kv_ttl_delete_max_ops](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090708) | 用于设置 TTL 任务删除的最大操作数。 |

### PL 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [plsql_code_type](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090698) | 用于指定 PL/SQL 代码的编译类型。 |
| [plsql_debug](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090633) | 用于指定是否编译成 debug 版本。 |
| [package_state_sync_max_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090696) | 用于控制单个 package state (包状态管理) 能序列化的长度。 |
| [ob_enable_java_udf](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090762) | 用于开启或关闭 Java UDF 功能。 |
| [enable_pl_rich_error_msg](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090717) | 用于开启或关闭向 PLSQL 内异常信息添加额外内容的功能。 |

### 旁路导入相关

| 配置项名 | 功能描述 |
| --- | --- |
| [default_load_mode](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090789) | 用于在导数操作场景中，控制数据的导入方式。 |
| [direct_load_allow_fallback](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090679) | 用于控制在指定旁路导入的导数操作中，如果遇到旁路导入不支持的场景时，导数操作是否回退为普通导入的方式。 |
| [load_data_diagnosis_log_compression](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090663) | 用于设置诊断日志使用的压缩算法。 |
| [load_data_diagnosis_log_max_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090729) | 用于设置单个诊断日志文件的大小。 |

### PX 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [px_target_high_watermark](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090658) | 用于控制并行线程数的高水位线百分比阈值。 |
| [px_target_low_watermark](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090731) | 用于设置并行线程数的低水位线百分比阈值。 |
| [px_target_workers_per_cpu](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090792) | 用于控制预期的并行执行线程数和租户 CPU 数的比率。 |

### 其他

| 配置项名 | 功能描述 |
| --- | --- |
| [zone_deploy_mode](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090756) | 设置租户在各 Zone 的分布模式。 |
| [enable_early_lock_release](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090649) | 用于设置是否开启提前解行锁的功能。 |
| [workarea_size_policy](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090716) | 用于设置手动或者自动调整 SQL 工作区大小的策略。 |
| [open_cursors](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090650) | 用于限制单个 Session 可以同时打开的游标数量。 |
| [ob_ssl_invited_common_names](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090784) | 用于记录当前租户运行的应用身份列表，该身份来自 SSL 双向认证中 Client 端证书 `subject` 中的 `cn` 字段（common name）。 |
| [ob_enable_batched_multi_statement](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090795) | 用于设置是否启用批处理功能的成组执行优化。 |
| [default_auto_increment_mode](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090781) | 用于设置默认的自增列自增模式。 |
| [ob_query_switch_leader_retry_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090692) | 用于设置失败 Query 的最大重试时间，单位为微秒（us）。 |
| [default_enable_extended_rowid](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090754) | 用于设置是否将表创建为 Extended ROWID 模式。 |
| [dump_data_dictionary_to_log_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090683) | 用于控制租户数据字典持久化的周期。 |
| [enable_user_defined_rewrite_rules](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090788) | 用于控制用户自定义规则是否开启的开关。 |
| [storage_rowsets_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090689) | 用于控制列存引擎一次向量化批处理行数。 |
| [approx_count_distinct_precision](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090757) | 用于配置 `approx_count_distinct` 函数的结果精度。 |
| [default_skip_index_level](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090742) | 用于设置租户中创建表时 `skip_index_level` 的默认值。 |
| [sql_func_extension_mode](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090743) | 用于控制是否启用命名风格与 MySQL 不一致的主流兼容模式函数。 |
| [enable_ps_parameterize](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090662) | 用于控制开启或关闭 PS 语句在解析时是否参数化。 |

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

| 配置项名 | 功能描述 |
| --- | --- |
| [log_disk_utilization_limit_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090736) | 用于设置租户日志盘利用率限制阈值，当租户日志盘使用量超过租户日志盘空间总量乘以该值时，不再允许日志写入。 |
| [log_disk_utilization_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090672) | 用于设置租户日志盘利用率阈值，当租户日志盘使用量超过租户日志盘空间总量乘以该值时，进行日志文件重用。 |
| [writing_throttling_maximum_duration](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090751) | 通过控制内存分配进度，控制写入速度。即指定在触发写入限速后，剩余 MemStore 内存分配完所需的时间。 |
| [writing_throttling_trigger_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090750) | 用于设置触发写入限速的 MemStore 已使用内存占 MemStore 内存上限的百分比阈值。 |
| [standby_db_fetch_log_rpc_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090724) | 用于设置备库拉取日志 RPC 超时时间，以控制备库日志传输服务检测主库某台 Server 不可用并切换到其他 Server。 |
| [log_disk_throttling_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090697) | 用于触发日志写入限速的不可回收日志盘空间占比。 |
| [log_transport_compress_all](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090632) | 用于对日志传输是否使用压缩。 |
| [log_transport_compress_func](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090668) | 用于日志传输的压缩器。 |

### 数据类型相关

| 配置项名 | 功能描述 |
| --- | --- |
| [json_document_max_depth](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090802) | 用于设置 JSON 文档中允许的最大嵌套层数。 |

### 锁相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_lock_priority](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090747) | 表锁优先级开关。 |

### 外表相关

| 配置项名 | 功能描述 |
| --- | --- |
| [external_table_io_hole_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090714) | 用于设置两个连续 IO 范围之间的最大距离（以字节为单位）。 |
| [external_table_io_range_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090758) | 用于设置合并范围的最大大小（以字节为单位）。 |
| [catalog_sync_target](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007109265) | 用于指定 Catalog 数据同步的目标 Catalog，即 Internal catalog 的库表元数据同步到 HMS 时使用的 HMS 类型 External Catalog。值为空时关闭同步。 |

### 系统日志相关

| 配置项名 | 功能描述 |
| --- | --- |
| [log_disk_throttling_maximum_duration](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090776) | 用于调整触发日志限速后，日志盘的最大可用时间。 |
| [ls_gc_delay_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090645) | 用于配置租户日志流延迟删除的时间。 |
| [standby_db_preferred_upstream_log_region](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090772) | 用于配置物理备库场景下，备租户同步上游日志的首选 Region。 |
| [archive_lag_target](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090671) | 用于控制租户日志归档延迟的时间。 |

### 物化视图相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_mlog_auto_maintenance](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090721) | 用于控制是否启用物化视图日志自动管理功能。 |
| [mlog_trim_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090752) | 用于控制物化视图日志（mlog）后台自动裁剪任务的调度周期。 |
| [enable_mv_binlog_minimal_mode](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090805) | 用于控制物化视图增量刷新场景中 `binlog minimal` 模式的开关。 |
| [mv_refresh_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090627) | 用于控制同一租户内可同时运行的物化视图刷新任务的数量，即物化视图刷新任务的最大并发数。 |

### 用户登录相关

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

### 压缩算法相关

| 配置项名 | 功能描述 |
| --- | --- |
| [spill_compression_codec](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090804) | 用于指定压缩算法类型以实现 SQL 执行过程中的数据落盘压缩。 |
| [ob_encoding_granularity](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090648) | 用于设定单个微块 Encoding 的行数上限。 |

### 转储与合并相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_window_compaction](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090799) | 用于指定当前租户是否使用窗口合并。 |
| [mds_minor_compact_trigger](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090701) | 用于控制触发 MDS Minor Compaction 的 SSTable 数量。 |
| [mds_compaction_mid_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090656) | 用于设置中优先级 MDS Compaction 的 DAG（Direct Acyclic Graph）线程数。 |
| [mds_compaction_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090732) | 用于设置高优先级 MDS Compaction 的 DAG（Direct Acyclic Graph）线程数。 |
| [default_progressive_merge_num](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090808) | 用于设置新建一张表时默认的渐进合并次数。 |
| [major_freeze_duty_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090807) | 用于设置每日定时冻结和合并的触发时刻。 |
| [major_compact_trigger](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090686) | 用于设置多少次冻结触发一次合并。 |
| [minor_compact_trigger](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090641) | 用于配置触发转储（Minor Compaction）的 SSTable 个数的阈值。 |
| [undo_retention](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090774) | 用于设置系统应保留的多版本数据范围，单位为秒，在转储时控制多版本数据的回收。 |
| [merger_check_interval](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090719) | 用于设置合并状态检查线程的调度间隔。 |
| [freeze_trigger_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090628) | 用于设置触发全局冻结的租户使用内存阈值。 |

### 仲裁服务相关

| 配置项名 | 功能描述 |
| --- | --- |
| [arbitration_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090768) | 用于设置触发自动降级的超时时间。 |

### TTL 相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_ttl](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090629) | 用于控制 SQL 模式下是否开启 TTL 功能。 |
| [ttl_duty_time](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090657) | 用于指定 TTL 后台定期触发 TTL 任务的执行时间点。 |

### AI 函数服务

| 配置项名 | 功能描述 |
| --- | --- |
| [document_ai_file_max_size](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090796) | 用于限制 `LOAD_FILE` 函数一次处理的文件最大大小。 |

### 逻辑表相关

| 配置项名 | 功能描述 |
| --- | --- |
| [enable_agent_db_background_task](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090725) | 用于控制是否开启逻辑表（Logical Table）后台删除任务。 |
| [agent_db_background_delete_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090681) | 用于设置逻辑表后台删除数据的线程数。 |
| [agent_db_hot_namespace_ttl](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090738) | 用于设置逻辑表热 Namespace 缓存的存活时间。 |

### 暂不支持的配置项

| 配置项名 | 功能描述 |
| --- | --- |
| [sql_work_area](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090782) | 用于设置租户的工作区内存。 |
| [max_stale_time_for_weak_consistency](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090753) | 用于设置弱一致性读允许读到多旧的数据。 |

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