配置项

默认值

说明

cluster

obcluster

应用名:OceanBase启动时CLUSTER唯一标识。

balancer_idle_time

5m

均衡任务空闲等待时间。取值范围：[10s, +∞)

migration_disable_time

3600s

服务器处于block_migrate_in状态，过了多久后会自动恢复成普通状态；block_migrate_in状态是指不能把partiton迁移到这台OBServer上。 取值范围：[1s,+∞)

merger_check_interval

10m

RootService检测合并进程的时间间隔。取值范围：[10s, 60m]

balancer_timeout_check_interval

1m

检查负载均衡任务是否超时的间隔。取值范围：[1s, +∞)

server_check_interval

30s

检查__all_server表状态任务时间间隔。 取值范围：[1s, +∞)

data_copy_concurrency

20

最大执行数据拷贝任务的并发数。取值范围： [1,+∞)

zone_merge_concurrency

2

并发的合并集群数。取值范围：[0,+∞)

location_cache_cpu_quota

1

核心表Location Cache的请求允许使用的CPU数。 取值范围：[0,10]

data_dir

store

数据存放目录。

enable_sys_table_ddl

FALSE

默认为false，如果需要建table_id小于1000的表，需要执行： alter system setenable_sys_table_ddl=’true’;

Devname

bond0

网卡名称。

datafile_size

0

数据文件的大小。取值范围：[0,+∞)

tablet_size

128m

分区内部并行处理时，分片的大小;数值为0表示不采用分区内并行。

取值范围：[0,+∞)

datafile_disk_percentage

90

数据文件占磁盘空间的百分比。取值范围：[5,90]

balancer_log_interval

1m

在日志中打印负载均衡任务统计信息的间隔。取值范围：[1s,+∞)

election_cpu_quota

3

选举租户CPU数目。 取值范围：[0,10]

enable_auto_leader_switch

TRUE

允许系统自动切主。

enable_manual_merge

FALSE

是否开启手动合并。• True：开启。 • False：不开启。 用于DBA管理错峰是否暂停，只有在enable_manual_merge为True的时max_merge_duration_time才有效。如果这个值为True，则认为DBA关闭自动合并。

enable_unit_balance_resource_weight

FALSE

是否启用人工指定的资源权重：

• True：启用。• False：不启用。

unit_balance_resource_weight

空

指定各种资源的权重，权重值用[0, 100]整数表示，如果命令中没有指定某一项，则该资源权重默认为0。字符串不区分大小写，如果disk+iops+memory+cpu不等于100，则报错。例：”disk:30,iops:20,memory:10,cpu:40”

enable_rebalance

TRUE

是否开启分区负载均衡。• True：开启。 • False：不开启。

enable_rereplication

TRUE

是否开启Partition的副本复制。如果不开启，则即使Partition的副本数小于设置的“ob_default_replica_num”，也不会进行复制。 • True：开启。 • False：不开启。

enable_stagger_merge

TRUE

是否开启错峰合并。

location_fetch_concurrency

20

获取Location Cache并发数。 取值范围：[1,1000]

enable_record_trace_log

TRUE

默认为true，表示只要出现错误，就一定打印trace log； TRACE_LOG默认日志级别为TRACE 1. 三个配置项： GCONF.trace_log_sampling_interval （默认10ms) GCONF.trace_log_slow_query_watermark (默认100ms) CONF.enable_record_trace_log (默认True)2. 默认情况下，慢查询（如有）会每隔sampling_trace_log_interval打印一次 3. 默认情况下，白名单中的错误码，只要出现，就一定打印 4. 默认情况下，除了2、3中规定的情况，其余时候都不打印TRACE LOG 5. 当enable_record_trace_log被设置为False的时候，每隔sampling_trace_log_interval会打印一次SLOW QUERY或白名单错误码日志

ignore_replica_checksum_error

FALSE

是否忽略副本校验错误。

location_cache_refresh_min_interval

100ms

事务模块两阶段提交协调者等待参与者的回复的超时时间。默认是100ms. 如果超时事务模块会发起location更新任务，但现在无主选举耗时需要(2s~8s)，为了避免多余的location更新sql，location cache内部执行异步更新任务时先判断cache中的location的更新时间，如果更新时间距离当前时间在1s内，location cache则忽略这次异步更新请求。事务模块在外层继续以100ms的频率触发。 取值范围：[0s,+∞)

internal_sql_execute_timeout

30s

内部SQL执行超时时间。 取值范围：[1000us,10m]

net_thread_count

8

用于设置Libeay的I/O线程数量，如net_thread_count为8，则代表rpc和mysql的libeasy的io线程各为8个线程。 取值范围： [1,100]

large_query_worker_percentage

30

预留给大请求的工作线程比例。取值范围：[0,100]

auto_leader_switch_interval

30s

RootService做Leader协调一致的时间间隔。 取值范围：[1s,+∞)

leak_mod_to_check

NONE

检查指定模块是否存在内存泄漏。

lease_time

10s

心跳租约时长。RootService在lease_duration_time这个时间段内未收到OBServer的心跳信息，则任务OBServer下线。 不建议修改。 取值范围：[1s, 5m]

location_cache_priority

1000

Location Cache的优先级。取值范围： [1, +∞)

location_cache_expire_time

600s

OBServer从RootService中获取Partition的位置信息，并缓存到本地的超时时间。 不建议修改。 取值范围：[1s, +∞)

location_refresh_thread_count

4

OBServer从RootService中获取Partition的位置信息的线程数。 取值范围：[1, 100]

major_freeze_duty_time

2:00

每天定时执行升级主版本号的冻结操作的时间。取值范围：[00：00-24：00]

major_freeze_trigger_percentage

70

此配置项用来计算major freeze触法阈值。 计算公式： major_freeze_trigger_percent =major_freeze触发阈值 /memstore的容量 memstore的容量，通过配置项memstore_lmt_percent计算所得。 计算公式：memstore_lmt_percent=memstore_limit/min_memory 取值范围：（0，100）

max_syslog_file_count

0

指定最多同时存在多少个日志文件，每个日志文件占用256M空间。当值为0时则不进行删除。 取值范围：[0, +∞)

zone_merge_timeout

3h

单个ZONE合并的超时时间。 取值范围：[1s, +∞)

zone_merge_order

空

每日合并过程中，zone的合并顺序

memory_limit

0

给测试用的内存大小的限制。（内部测试用）

memory_limit_percentage

80

内存使用上限。取值范围：[10，90]

cache_wash_threshold

1GB

内存预留值。如果内存空间小于指定值时，内存空间将被清理。取值范围： [0,+∞)

memstore_limit_percentage

50

此配置项用来计算Memstore_limit值。 memstore_lmt_percent = memstore_limit / min_memory，min_memory为创建租户的时候给定。 取值范围：（0，100）

mysql_port

2880

OBServer中的MySQL协议监听端口。 取值范围：(1024, 65536)

rpc_timeout

2s

默认RPC的超时时间。 取值范围：[0,+∞)

cpu_count

0

单个OBServer CPU数。如果为0，则根据sysconf获取cpu个数，否则使用该配置。 取值范围：[0,+∞)

cpu_reserved

2

节点预留的CPU数，节点配额为节点CPU总数减去该配置项。 取值范围：[0,15]

syslog_level

INFO

日志级别： DEBUG, TRACE, INFO, WARN, USER_ERR, ERROR

enable_syslog_warning_file

TRUE

是否存WARNING日志到.wf文件。

obconfig_url

OBConfig服务web页面地址。 OBServer从指定URL获取RootService的地址。

large_query_threshold

5ms

超过时间的请求可能被暂停，暂停后自动变成大请求。大请求鉴定阈值。 取值范围：[1ms,+∞)

plan_cache_evict_interval

10m

启动plan cache淘汰机制的间隔时间。 取值范围：[0,+∞)

plan_cache_high_watermark

2000M

已废弃。Plan Cache使用内存上限。 取值范围：[0, 内存最大值]

plan_cache_low_watermark

1500M

已废弃。Plan Cache内存使用下限。 取值范围：[0, 内存最大值） 且plan_cache_low_watermark < plan_cache_high_watermark

partition_table_scan_batch_count

1024

Partition Table遍历时预读的副本数。取值范围：(0, 65536]

balancer_task_timeout

20m

负载均衡任务超时时间。取值范围：[[1s,+∞)

enable_syslog_recycle

FALSE

是否打开记录旧日志的开关。配合max_syslog_file_count生效，用于回收旧的日志文件

memory_reserved

500M

预留内存大小。取值范围：[10M,最大内存值]

resource_hard_limit

100

分配unit使用。和resource_soft_limit配置项一起使用。 如果server的资源占用比少于resource_soft_limit，按best_fit来分配unit；如果大于resource_soft_limit，我是按照leaset_load来分配unit。 最终server资源占比不能超过resource_hard_limit 取值范围：(0, 10000]

resource_soft_limit

50

分配unit使用。和resource_hard_limit配置项一起使用。 如果server的资源占用比少于resource_soft_limit，按best_fit来分配unit；如果大于resource_soft_limit，我是按照leaset_load来分配unit。 最终server资源占比不能超过resource_hard_limit 取值范围：(0, 10000]

rootservice_ready_check_interval

3s

启动RootService的时候，restart task失败重试间隔。 取值范围：[100000us, 1m]

rootservice_list

RootService列表；选主协议会基于这个列表对内部消息的有效性进行验证。

rootservice_async_task_queue_size

16384

RootService异步任务队列大小，为2的N次方。 取值范围：[8,131072]

rootservice_async_task_thread_count

1

RootService异步任务线程数。取值范围：[1, 10]

rpc_port

2500

远程访问的协议端口。取值范围：(1024, 65536)

trace_log_sampling_interval

10ms

TRACE_LOG默认日志级别为TRACE慢查询（如有）会每隔trace_log_sampling_interval打印一次日志。 当enable_record_trace_log被设置为False的时候，每隔trace_log_sampling_interval会打印一次SLOW QUERY或白名单错误码日志。 取值范围：[0ms,+∞)

server_data_copy_in_concurrency

2

迁移任务时，机器同时迁入的任务数不超过指定值。取值范围：[1,+∞)

server_data_copy_out_concurrency

2

迁移任务时，机器同时迁出的任务数不超过指定值。取值范围：[1,+∞)

system_cpu_quota

3

system租户（一个特殊的租户，每台server上默认都有）能使用CPU数。 取值范围：[0,10]

server_permanent_offline_time

3600s

服务器永久下线时间。取值范围：[20s,+∞)

server_temporary_offline_time

60s

服务器临时下线时间。取值范围：[15s,+∞)

trace_log_slow_query_watermark

100s

打印trace log慢查询控制阈值。 取值范围：[1ms,+∞)

enable_rootservice_standalone

FALSE

enable_rootservice_standalone配置项，使系统租户可独占单独的机器。

sys_cpu_quota_max

6

系统租户CPU最大配额。 取值范围：[2,100]

sys_cpu_quota_min

4

系统租户CPU最小配额。 取值范围：[2,100]

user_cpu_quota_max

100

用户租户CPU最大配额。 取值范围：[0,500]

user_cpu_quota_min

1

用户租户CPU最小配额。 取值范围：[0.1,10]

tenant_task_queue_size

65536

每个租户线程队列大小。取值范围：[1024,+∞)

workers_per_cpu_quota

10

工作线程与节点配额的倍数，默认10倍。 取值范围：[2,20]

token_reserved_percentage

30

每次预留多少比例的空闲token数给租户（不超过上限）。 取值范围：[0,100]

trx_2pc_retry_interval

100ms

事务两阶段过程中重试间隔。取值范围：[1ms,1000ms]

clog_sync_time_warn_threshold

100ms

commitlog同步超过多长时间报WARN日志。 取值范围：[1ms,1000ms]

balancer_tolerance_percentage

10

单元不均衡忍耐度；单元负载平均(unit使用磁盘平均)。如zone中有unit1, unit2，对应磁盘使用比例为 80%, 20%，平均磁盘使用率为50%，配置的不均衡忍耐度(unit_load_tolerance_percent)为10%。 取值范围：[5, 100)

virtual_table_location_cache_expire_time

8s

虚拟表Location Cache过期时间。 取值范围：[1s,+∞)

zone

ZONE名称。

enable_sql_audit

TRUE

是否开启sql审计功能，默认值为TRUE表示开启SQL审计功能。 取值为TRUE,FALSE

sql_audit_queue_size

已被取消

在OB 1.0.6版本中被取消(2016/5/30)

sql_audit_memory_limit

3G

开启SQL审计功能状态下，SQL审计内部表最大可用内存，默认为256MB。 取值范围:[256M, +∞)

ob_interm_result_mem_limit

2G

当前租户的执行sql的过程中的中间结果能占用的最大内存，单位为byte 取值范围:[128M,128G]

max_string_print_length

500

控制打印字符串最大长度。代码中不指定长度时，使用GCONF中的长度。 默认最长500个字节。 修改默认值的方法：alter system set max_string_print_length =1000;单位为byte 取值范围:(0,+∞)

eplica_safe_remove_time

7d

OBServer上存在的Replica，在Partition Table上能安全删除的时间间隔。 默认值是7天。 取值范围:(1min,+∞)

partition_table_check_interval

1d

Partition Table清理的时间间隔。默认值是1天。 取值范围:(1min,+∞)

dynamic_data_balance_limit

20

RootService按动态数据与unit memory配额的百分比，和磁盘使用率(静态数据占unit disk配额的百分比)两个维度做均衡。

优先做动态数据百分比均衡，再做磁盘均衡，在做磁盘均衡时不可打破动态数据百分比均衡。dynamic_data_balance_limit:表示只有当动态数据百分比大于此配置项指定值时才做均衡;和dynamic_data_balance_tolerance（动态数据百分比只能高于平均值加此配置项指定值)配合使用。 动态数据均衡触发条件为：

dynamic_data_percentage > max(dynamic_data_balance_limit,avg_dynamic_data_percentage + dynamic_data_balance_tolerance) 当一个unit达到触发条件后，尝试选一些partition迁移，且迁移后目的unit不能达到动态数据迁移触发条件。 默认值是20。 取值范围:[0, 100]

dynamic_data_balance_tolerance

10

RootService按动态数据与unit memory配额的百分比，和磁盘使用率(静态数据占unit disk配额的百分比)两个维度做均衡。

优先做动态数据百分比均衡，再做磁盘均衡，在做磁盘均衡时不可打破动态数据百分比均衡。dynamic_data_balance_tolerance:动态数据百分比只能高于平均值加此配置项指定值；和dynamic_data_balance_limit(只有当动态数据百分比大于此配置项指定值时才做均衡)配合使用。 动态数据均衡触发条件为：

dynamic_data_percentage > max(dynamic_data_balance_limit,avg_dynamic_data_percentage + dynamic_data_balance_tolerance) 当一个unit达到触发条件后，尝试选一些partition迁移，且迁移后目的unit不能达到动态数据迁移触发条件。 默认值是10。 取值范围:[0, 100]

enable_upgrade_mode

false

enable_upgrade_mode : “specifies whether upgrade mode is turnedon. If turned on, daily merger and balancer will be disabled. Value: True:turned on; False: turned off;”

进入升级模式时系统会关闭partition迁移复制等需要禁止的功能，后续在升级时都需要禁止的内容（比如升级时不能进行DDL等），都统一通过这个系统配置项控制，这样升级流程更简单，升级前设置enable_upgrade_mode为ture，升级后设置enable_upgrade_mode为false

schema_history_expire_time

724

schema历史版本的保留时间，单位为小时，取值范围为[1—3024]；the max time for reservingschema history, default is 724 hours

merger_completion_percentage

95

范围：[5, 100]，表示合并的partition数和数据量达到这个百分比后，即认为合并完成。the merged partition count percentage and merged data sizepercentage when MERGE is completed

min_observer_version

无需用户设置，用于OB版本升级时记录最小版本号

bf_cache_miss_count_threshold

100

用于控制bloomfilter cache的触发次数，当宏块miss次数达到这个值时，给创建bloomfilter cache。默认100，0表示关闭

enable_rich_error_msg

false

控制observer返回给客户端的文本错误消息内容，仅当SQL执行错误时有意义。当取值为true时，会在错误消息前添加（1）observer的ip:port （2）出错时间(3) 日志TraceID；取值为false时，不保持文本错误消息内容不变。

sys_bkgd_io_percentage

10

默认值：10，取值范围[5，99]，用于控制系统io（合并、迁移等）所占的资源比例。

sys_bkgd_net_percentage

60

默认值：60，取值范围[0，100]，0表示关闭,100表示不限流。用于控制系统维护操作（合并、迁移等）所占的网络资源比例。

merge_thread_count

0，动态

取值范围：[0, 64], 默认值：0，默认值为0时，则合并线程数与目前是一样，即MIN[逻辑CPU数30%, 10]. 说明：用于设置每日合并工作的线程数。动态参数，修改后不需要重启即刻生效

autoinc_cache_refresh_interval

0，动态

取值范围：[100ms, +∞]， 默认值：10s ，说明：自增列刷新非NULL值的间隔时间。动态参数，修改后不需要重启即刻生效。

global_write_halt_residual_memory

INT，动态

取值范围：[0-100]， 默认值：30 ，说明：控制全局禁写时剩余内存量，当全局剩余内存比global_write_halt_residual_memory小时，普通租户就禁止写入，sys租户不受影响，回放也不受影响。 这个配置项是个百分比，百分比基数是:memory_limit (1 - system_memory_percentage/100)，也即扣掉了为OB内部500租户预留的内存。计算剩余内存的时候，blockcache可以挤占的那部分内存看作memstore可以使用的内存。

global_major_freeze_residual_memory

INT，动态

取值范围[0-100], 且需要比global_write_halt_residual_memory大，否则全局freeze trigger实际不生效，只能依靠tenant触发major freeze， 默认值：65 。说明：用来控制全局触发freeze的剩余内存量，当active memstore全局可用内存(停写之前可以继续写入的内存)比global_major_freeze_residual_memory小时，触发majorfreeze。 这个配置项是个百分比，百分比基数是:memory_limit (1 - system_memory_percentage/100)，也即扣掉了为OB内部500租户预留的内存。 已经冻结的memstore在merge完成后，内存就可以释放，所以冻结的memstore占用的内存在这里被看作是active_memstore可以使用的内存， blockcache可以挤占的那部分内存也被看作是memstore可以使用的内存。

enable_global_freeze_trigger

BOOL，动态

取值范围：TRUE|FALSE, 用来控制全局的freeze trigger和全局的memstore limit是否生效，缺省为False即不生效，改为True之后会生效

minor_freeze_times

INT、动态

取值范围：[0, 65536), 默认值：3，作用说明：当内存超过预设限制后会触发minor freeze或major freeze，此选项指定在触发的连续两次major freeze之间触发的minor freeze次数。0表示禁止自动触发minor freeze。

minor_warm_up_duration_time

time

取值范围：[0s,60m], 默认值：30s，作用说明：指定转储生成的静态版本预热过程执行的时间，当设置为0s时不进行预热。

rder

无

类型为字符串，动态生效，默认值无，作用：指定ZONE轮转合并的顺序

get_leader_candidate_rpc_timeout

9s

INT类型，单位us，取值范围[2s-180s]，动态参数，设置获取leader candidate的 RPC超时时间，单位us

max_kept_major_version_number

2

INT类型，取值范围[1,16]，动态参数，每日合并保留的基线数据大版本数量

memory_chunk_cache_size

1G

作用：设置memory chunk的缓存大小，默认1G，取值范围[32M,+∞)，可动态修改生效

trx_try_wait_lock_timeout

20ms

类型：时间，默认值：20ms，范围[0，+∞)，作用：每次行锁的最长等待时间，可动态修改生效

cpu_quota_concurrency

2

类型：INT，默认值：2，范围：[1,4]，作用：每个cpu quota对应的worker的并发数，可动态修改生效。

max_availability_for_weak_consistency

5s

表示只读副本和follower在上游失效的时候，允许的最大数据时效间隔。

enable_standalone_mode_for_weak_consistency

False

开启高可用只读zone功能

default_compress_func

lz4_1.0

持久化存储中表数据的缺省压缩函数

sys_bkgd_migration_change_member_list_timeout

30m

时间类型，取值范围 [0s,24h]。用于控制迁移中更改member list的超时，默认30m，0表示不重试。。

sys_bkgd_migration_retry_num

3

INT类型，取值范围[3,100]。用于控制迁移中允许重试的次数。

sys_bkgd_io_timeout

30s

时间类型，取值范围[5s,60s]。用于控制后台io的超时时间。

data_disk_usage_limit_percentage

90

INT类型，取值范围[50,100]。用于磁盘警报的警戒线，是个百分比。

merge_stat_sampling_ratio

10

INTL类型，取值范围[0,100]。每日合并期间统计值收集的采样率。当设置为0时，关闭统计值的收集。

multiblock_read_size

128K

IO聚合读block时大小设置

multiblock_read_gap_size

0K

一次IO读取时最大间隙大小

config_additional_dir

etc2;etc3

额外的配置文件保存目录

debug_sync_timeout

0

DebugSync功能超时时间

enable_perf_event

False

是否打开Perf Event功能

enable_separate_sys_clog

False

是否分别记录普通租户的clog

max_stale_time_for_weak_consistency

无

enable_causal_order_read

False

是否打开原子因果序读

cluste_id

0

集群ID

syslog_io_bandwidth_limit

30MB

系统日志IO带宽限流

enable_syslog_wf

True

是否单独保存Warning以上日志级别的日志到文件中

enable_sql_operator_dump

False

是否允许SQL算子将中间结果写到磁盘上

tenant_cpu_variation_per_server

已取消

system_memory_percentage

20

observer自身预留内存的百分比，该内存将不能分配给租户

merger_switch_leader_duration_time

3m

每日合并切主的时间间隔

balancer_emergency_percentage

80

Unit复杂大于该比例后将允许开启副本向外迁移

tenant_groups

RS进行负载均衡时使用的租户组配置

server_balance_critical_disk_waterlevel

80

observer开启基于磁盘空间的负载均衡功能的水位线

server_balance_disk_tolerance_percent

5

当各个server间的磁盘容量小于该比例时，磁盘负载均衡结束。

enable_merge_by_turn

True

是否开启轮转合并

row_purge_thread_count

4

row purge允许的最大工作线程数

row_compaction_update_limit

6

row ompaction允许的最大工作线程数

ignore_replay_checksum_error

False

是否关闭日志回放checksum检查

trx_force_kill_threshold

100ms

切主时对事务的最长等待时间

clog_disk_usage_limit_percentage

95

clog的磁盘空间大于该比例时停止clog写入

all_server_list

集群中的所有server列表

clog_cache_priority

1

clog缓存优先级

index_clog_cache_priority

1

index clog缓存优先级

user_tab_col_stat_cache_priority

1

用户表列统计信息缓存优先级

index_cache_priority

10

无

index_info_block_cache_priority

1

无

user_block_cache_priority

1

用户表的块缓存优先级

user_row_cache_priority

1

用户表的行缓存优先级

bf_cache_priority

1

Bloom Filter缓存优先级

bf_cache_miss_count_threshold

100

Bloom Filter缓存未命中数的上限，0表示关闭该缓存

sys_bkgd_io_low_percentage

0

后台任务预留的io使用比例

sys_bkgd_io_high_percentage

90

后台任务可以使用的io比例上限

sys_cpu_limit_trigger

80

当server cpu使用大于该比例时，停止后台任务执行

user_iort_up_percentage

100

当io rt大于该比例后，停止后台任务执行

minor_merge_concurrency

0

小版本转储并发线程数

restore_concurrency

0

备份恢复并发线程数