#配置参数

YashanDB通过调整配置参数开放系统运行配置能力,产品安装时所有配置参数均已设定默认值,后续实际使用过程中可以根据业务、性能等需求对其进行调整,具体操作请查阅参数配置

参数属性

  • 修改立即生效:表示通过ALTER SYSTEM SET语句设置参数时是否可以实时生效。

  • 会话级参数:表示是否可通过ALTER SESSION SET语句设置该参数为会话级生效。

  • 只读参数:建库后不支持修改。

  • 引入版本:表示参数从该版本开始被引入。

  • 过时版本:表示参数从该版本开始不再推荐使用,保留仅为版本兼容,若干个版本后将直接废弃。系统中配置使用后,会产生运行日志告警,不影响启动。

首字母索引

A B C D E G H I J L M N O P Q R S T U V W Y

# AC_MAX_SOURCE_SLICE_COUNT

  • 参数类型:数值

  • 默认值:20

  • 取值范围/格式:[1,256]

  • 参数说明:指定AC Slice最多对应原表Slice数量,用于设置AC生成规则。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# AC_SLICE_THRESHOLD_SIZE

  • 参数类型:数值

  • 默认值:64M

  • 取值范围/格式:[1M,512M]

  • 参数说明:指定AC Slice生成数据大小,用于设置AC生成规则。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# ARCH_CLEAN_IGNORE_MODE

  • 参数类型:字符串

  • 默认值:NONE

  • 取值范围/格式:NONE、BACKUP、STANDBY、BOTH

  • 参数说明:指定清理归档文件时的忽略模式,忽略备份表示无论该归档文件是否已备份均会被清理,忽略备库表示无论该归档文件是否已被所有备库获取均会被清理。

    • NONE表示清理归档文件时不忽略备份和备库。

    • BACKUP表示清理归档文件时忽略备份。如果不需要备份,请将该参数设置为BACKUP。

    • STANDBY表示清理归档文件时忽略备库。如果不需要等待备库,请将该参数设置为STANDBY,但容易造成备库跟不上主库出现need repair状态。

    • BOTH表示清理归档文件时忽略备份和备库。如果不需要备份和备库,请将该参数设置为BOTH。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# ARCH_CLEAN_LOWER_THRESHOLD

  • 参数类型:数值

  • 默认值:12G

  • 取值范围/格式:[0,32T]

  • 参数说明:指定自动清理归档功能的停止条件。该功能一旦被触发会自动删除当前数据库的归档日志,直到现存归档日志和下一个即将产生的归档日志的大小总和不超过该值时才自动停止。该值不能大于ARCH_CLEAN_UPPER_THRESHOLD。设置为0时,表示清理所有可以清理的归档日志。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# ARCH_CLEAN_UPPER_THRESHOLD

  • 参数类型:数值

  • 默认值:16G

  • 取值范围/格式:[0,32T]

  • 参数说明:指定当前数据库产生的所有归档日志允许占据的最大空间。归档前系统会测算即将产生的归档日志与现存所有归档日志的总量是否会超过该值,是则先触发自动清理归档功能,清理完成后再产生新的归档日志。该值仅作为自动清理归档功能的触发条件,即使归档日志总和超过该值也不影响事务正常运行。该值不能小于ARCH_CLEAN_LOWER_THRESHOLD。设置为0时,表示关闭自动清理,不会自动清理归档日志。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# ARCHIVE_DEST_1 ~ 32

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:ARCHIVE_DEST_XXX='SERVICE=IP:port VALID_FOR=链路生效范围 DB_UNIQUE_NAME=备库名称 NODE_ID=节点编号 AFFIRM=YES/NO NET_TIMEOUT=网络超时时间'

  • 参数说明:指定备库的配置,有以下参数:

    • SERVICE:定义备库的IP和port;共享集群下,需填写备库所有实例的IP和port,每组IP和port用逗号分开,不能包含空格。

    • VALID_FOR:定义备库链路生效范围,默认为PRIMARY_ROLE,表示当前实例为主库时生效。STANDBY_ROLE表示当前实例为备库时生效,ALL_ROLES表示任何时候都生效。

    • DB_UNIQUE_NAME:定义备库的名称,不配置的使用默认值standby+id,该值必须唯一,不能和别的备库重复,不区分大小写。

    • NODE_ID:自动选主模式下的节点编号,格式group-node:endpoint,该值必须唯一,不能和别的备库重复。

    • AFFIRM:最大可用模式下,备库是否将日志刷盘后再回复ACK,设为NO有性能提升,但可能丢失数据,默认为YES。

    • NET_TIMEOUT:最大可用模式下,等待备库恢复ACK的超时时间,取值范围为[3,1000],单位为秒,默认为30秒。

    配置若干条备库链路的示例:

    • ARCHIVE_DEST_1='SERVICE=127.0.0.1:2801',表示备库1的地址,备库类型为普通备,使用默认名称standby1。

    • ARCHIVE_DEST_2='SERVICE=127.0.0.1:2802 VALID_FOR=STANDBY_ROLE NODE_ID=1-1:1',表示备库2的地址,备库类型为级联备,使用默认名称standby2,节点编号是1-1:1。

    • ARCHIVE_DEST_3='SERVICE=127.0.0.1:2803 VALID_FOR=ALL_ROLES AFFIRM=YES',表示备库3的地址,备库类型既为普通备也为级联备,使用默认名称standby3。

    • ARCHIVE_DEST_4='SERVICE=127.0.0.1:2804 DB_UNIQUE_NAME=shenzhen1',表示备库4的地址,备库类型为普通备,使用名称shenzhen1。

    共享集群下,上述示例的SERVICE参数需填写备库所有实例的IP和port,以备库1为例,其余备库以此类推:ARCHIVE_DEST_1='SERVICE=127.0.0.1:2801,127.0.0.1:2901'

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# ARCHIVE_LOCAL_DEST

  • 参数类型:字符串

  • 默认值:?/archive

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定存放归档文件的目录路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# AUDIT_FLUSH_INTERVAL

  • 参数类型:数值

  • 默认值:100

  • 取值范围/格式:[50,5000]

  • 参数说明:异步写审计记录时间时间间隔,单位为毫秒。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# AUDIT_QUEUE_SIZE

  • 参数类型:数值

  • 默认值:16M

  • 取值范围/格式:[4M,32M]

  • 参数说明:异步写审计记录占用内存空间大小。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# AUDIT_QUEUE_WRITE

  • 参数类型:布尔值

  • 默认值:TRUE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定是否使用异步写审计日志模式。TRUE表示异步写审计日志模式,FALSE表示直接写审计日志模式。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# BLOCK_REPAIR_ENABLED

  • 参数类型:布尔值

  • 默认值:TRUE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定页面修复功能是否打开。TRUE表示主库发生磁盘页面损坏时,自动从备库获取正确的页面,修复损坏的磁盘页面;FALSE表示主库不启用数据页面自动修复。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# BLOCK_REPAIR_TIMEOUT

  • 参数类型:数值

  • 默认值:60

  • 取值范围/格式:[1,3600]

  • 参数说明:主库启动数据页面自动修复时,从备库获取正确页面的超时时间,单位为秒。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# BLOOM_FILTER_FACTOR

  • 参数类型:数值

  • 默认值:0.3

  • 取值范围/格式:[0,1]

  • 参数说明:指定bloom filter计划选择的阈值,即底层计划选择率小于该值时,会使用bloom filter。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v22.2

# BROADCAST_GTS_TIME

  • 参数类型:数值

  • 默认值:5

  • 取值范围/格式:[1,1000]

  • 参数说明:GTS同步时间,单位为毫秒。参数已过时,新参数请查阅GTS_BROADCAST_TIME

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

  • 过时版本:V23.2

# BUCKET_RESERVED_SPACE

  • 参数类型:数值

  • 默认值:1G

  • 取值范围/格式:[100M,264-1]

  • 参数说明:指定表空间中的databucket所在磁盘预留空间大小,例如设置值为1G,表明当磁盘空间小于等于1G时系统不再允许向此databucket写入数据。此外当databucket的剩余空间小于该值时,会优先使用其他空间足够的databucket,如果表空间的所有databucket空间都小于该值,则优先选择剩余空间最大的databucket。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# BULKLOAD_MAX_MEM_PERCENT

  • 参数类型:数值

  • 默认值:80

  • 取值范围/格式:[1,100]

  • 参数说明:指定进行BULKLOAD导入时,所有导入任务使用的物化内存占COLUMNAR_VM_BUFFER_SIZE的上限百分比。如果当前导入任务的内存换出严重,建议适当调大此参数。导入过程中所有导入线程的最大可用内存按如下公式配置:COLUMNAR_MATERIAL_PERCENT * COLUMNAR_VM_BUFFER_SIZE * BULKLOAD_MAX_MEM_PERCENTT。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# CGROUP_FLAG

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:[0,1]

  • 参数说明:CPU资源管理功能开关,目前仅在单机部署和分布式部署下才生效。参数已过时,新参数请查阅RSRC_MODE

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

  • 过时版本:V23.2

# CHARACTER_SET

  • 参数类型:字符串

  • 默认值:UTF8

  • 取值范围/格式:ASCII、ISO88591、GBK、UTF8、GB18030

  • 参数说明:指定数据库使用的字符集。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:是

  • 多节点是否要求一致:是

  • 引入版本:v22.1

# CHECKPOINT_INTERVAL

  • 参数类型:数值

  • 默认值:100000

  • 取值范围/格式:[0,264 -1]

  • 参数说明:指定触发checkpoint的从恢复点到当前redo日志刷盘点的redo大小间隔,单位为字节。每次触发checkpoint都会清理数据库的脏块,释放可用的redo日志空间。如果间隔过大,会导致脏页积累过多或无可用redo日志空间,影响数据库性能。同时会影响数据库宕机之后重启恢复时间。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# CHECKPOINT_TIMEOUT

  • 参数类型:数值

  • 默认值:300

  • 取值范围/格式:[0,232 -1]

  • 参数说明:指定触发checkpoint的时间间隔。每次触发checkpoint都会清理数据库的脏块,释放可用的redo日志空间。如果间隔过大,会导致脏页积累过多或无可用redo日志空间,影响数据库性能。同时会影响数据库宕机之后重启恢复时所需时间。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# CLUSTER_DATABASE

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定当前数据库是否为集群数据库。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# CLUSTER_INTERCONNECT

  • 参数类型:字符串

  • 默认值:127.0.0.1:1700

  • 取值范围/格式:IP地址:端口号

  • 参数说明:集群实例间的通信地址。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# CLUSTER_MESSAGE_POOL_SIZE

  • 参数类型:数值

  • 默认值:64M

  • 取值范围/格式:[32M,8G]

  • 参数说明:共享集群消息池占用内存空间大小。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# CLUSTER_RECONNECT_TIME

  • 参数类型:数值

  • 默认值:5000

  • 取值范围/格式:[1000,3600000]

  • 参数说明:指定集群场景下,内部网络重连时间,单位为毫秒。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# CLUSTER_SERVICE

  • 参数类型:字符串

  • 默认值:

  • 取值范围/格式:UDS/IPC文件路径

  • 参数说明:数据库实例与集群管理服务的通信文件路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# CM_ADDR

  • 参数类型:字符串

  • 默认值:1-1:1/127.0.0.1:1679

  • 取值范围/格式:节点ID:ENDPOINT/IPV4地址:端口 或 节点ID:ENDPOINT/[IPV6地址]:端口

  • 参数说明:指定分布式场景下分布式集群管理节点的地址。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# COLUMNAR_BULK_SIZE

  • 参数类型:数值

  • 默认值:1024

  • 取值范围/格式:[1,100000]

  • 参数说明:指定列存计算每批次记录行数,需要所有节点的配置都一致。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v22.1

# COLUMNAR_MATERIAL_PERCENT

  • 参数类型:数值

  • 默认值:80

  • 取值范围/格式:[10,90]

  • 参数说明:指定列存计算排序、物化、join等算子使用物化内存占COLUMNAR_VM_BUFFER_SIZE的百分比。当列存计算中,排序、物化、join等涉及的数据量较多时,建议调大此参数,加快计算性能。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# COLUMNAR_VM_BUFFER_SIZE

  • 参数类型:数值

  • 默认值:2G

  • 取值范围/格式:[128M,2T]

  • 参数说明:指定列存计算使用的内存大小。当列存计算中,排序、物化、join等涉及的数据量较多时,建议调大此参数,可以增加计算性能。当LSC表以BULKLOAD模式导入,提示该配置参数不足时,需要调大该配置参数。导数时,为保证导入不因内存不足报错,请至少保证每个服务端导入线程内存最小为300M。其中服务端导入线程数量计算方法为:MIN(DEGREE_OF_PARALLELISM,CPU核数 * 4),客户端模式导入时,服务端线程数量为SENDERS参数大小。如多线程导入内存报错,可以调整SESSION_BULKLOAD_MAX_MEM_PERCENT,防止因导入线程间内存争用导致部分线程内存不足报错。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# COLUMNAR_VM_SWAP_SIZE

  • 参数类型:数值

  • 默认值:200G

  • 取值范围/格式:[100M,100T]

  • 参数说明:指定列存计算数据文件使用的磁盘大小。当列存计算中,排序、物化、join等涉及的数据量较多时,建议调大此参数。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# COLUMNAR_WORK_AREA_HEAP_SIZE

  • 参数类型:数值

  • 默认值:64M

  • 取值范围/格式:[32M,512G]

  • 参数说明:指定会话内列存执行内存区大小,推荐使用默认值。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# COMMIT_LOGGING

  • 参数类型:字符串

  • 默认值:IMMEDIATE

  • 取值范围/格式:IMMEDIATE、BATCH

  • 参数说明:指定COMMIT时日志刷写的模式(COMMIT_WAIT为NOWAIT时,本参数无效)。

    • IMMEDIATE:立刻触发日志刷盘。

    • BATCH:等待一段时间,积累一批事务后再触发日志刷盘。BATCH模式在短事务高并发且redo所在磁盘的IO是瓶颈的情况下,对数据库性能有提升,但其他情况下均可能造成性能下降,请慎用。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# COMMIT_WAIT

  • 参数类型:字符串

  • 默认值:WAIT

  • 取值范围/格式:WAIT、NOWAIT、FORCE_WAIT(仅支持系统级参数)

  • 参数说明:指定COMMIT时是否等待日志刷写,建议使用默认值。

    • WAIT:需等待日志全部落盘。

    • NOWAIT:事务提交时无需等待日志落盘即返回成功。设置为NOWAIT后,若发生宕机可能导致数据不一致,如果是最大保护模式,主库事务提交也不会等待备库接收日志,请慎用。

    • FORCE_WAIT:需等待日志全部落盘。若设置为FORCE_WAIT,则将无视COMMIT语句中指定的NOWAIT。若设置为FORCE_WAIT时,调整会话级参数不生效。

  • 修改立即生效:否

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v22.2

# COMPRESSION

  • 参数类型:字符串

  • 默认值:LZ4

  • 取值范围/格式:UNCOMPRESSED、LZ4、ZSTD

  • 参数说明:指定LSC存储引擎的压缩方式。UNCOMPRESSED表示不进行压缩,LZ4表示采用LZ4算法压缩,ZSTD表示采用ZSTD算法压缩。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# COMPRESSION_LEVEL

  • 参数类型:字符串

  • 默认值:LOW

  • 取值范围/格式:LOW、MEDIUM、HIGH

  • 参数说明:指定LSC存储引擎的压缩级别。LOW表示低级别压缩,MEDIUM表示中级别压缩,HIGH表示高级别压缩。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# CONTROL_FILES

  • 参数类型:字符串

  • 默认值:('?/dbfiles/ctrl1', '?/dbfiles/ctrl2', '?/dbfiles/ctrl3')

  • 取值范围/格式:(控制文件1, 控制文件2, …控制文件n)

  • 参数说明:指定控制文件的路径。最多可以指定8个控制文件,互为备份。用于避免单个控制文件损坏后,数据库无法启动的场景。数据库启动时,从指定路径加载控制文件均失败,会导致数据库启动失败。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# CURRENT_SCHEMA

  • 参数类型:字符串

  • 默认值:CURRENT_SCHEMA

  • 取值范围/格式:SCHEMA字符串

  • 参数说明:该参数为所在会话的当前schema属性。所有数据库对象被真实表述为schema.对象名,当用户访问某个数据库对象时未显式指定schema,默认指定为当前schema。当连接一个会话时,初始的current_schema为当前所登录用户对应的schema,通过ALTER SESSION语句可以动态地改变这个值。改变后,所有在此会话中执行的SQL语句的默认schema均为修改后的current_schema。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v22.1

# CURSOR_POOL_SIZE

  • 参数类型:数值

  • 默认值:32M

  • 取值范围/格式:[16M, 64T]

  • 参数说明:指定共享缓存区中游标缓存区的内存大小。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# DATA_BUFFER_SIZE

  • 参数类型:数值

  • 默认值:256M

  • 取值范围/格式:[32M,64T]

  • 参数说明:指定数据缓存区的大小。数据缓存区容量越大,数据库整体性能越好。容量过小会产生频繁的数据块换入换出,如果发现FREE BUFFER WAIT等待事件过多,需要增加数据缓存区的容量。建议数据缓存区配置至少为1G,该参数设置过小会出现启动或建库失败,可用最小值受到参数DB_BLOCK_SIZE以及建库指定的UNDO_SEGMENTS影响,最小值近似公式:(UNDO_SEGMENTS * 99 + 1K) * DB_BLOCK_SIZE,UNDO_SEGMENTS和DB_BLOCK_SIZE参考[CREATE DATABASE](../开发手册/SQL参考手册/SQL语句/CREATE DATABASE),计算时UNDO_SEGMENTS最小取64。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# DATA_RETENTION

  • 参数类型:数值

  • 默认值:3600

  • 取值范围/格式:[0,2592000]

  • 参数说明:指定LSC表数据被删除、转换及合并后那一刻开始,仍被保留的时间,单位为秒。超过本参数规定的时间时,数据可能被真正删除,不能再被较早时间的查询查到。当某个查询LSC表操作持续时间较长时,可适当调大此参数避免“快照过旧”错误。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# DATA_TRANSFORMER_ENABLED

  • 参数类型:布尔值

  • 默认值:TRUE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:是否允许后台自动进行transformer动作。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# DATA_TRANSFORMER_MAX_WORKERS

  • 参数类型:数值

  • 默认值:32

  • 取值范围/格式:[1,256]

  • 参数说明:LSC表后台转换任务的最大线程数。调大此参数可以加快LSC后台转换任务执行的速度,但同时可能增加后台任务占用资源;调小此参数可能减少后台任务资源的占用,但也会降低LSC后台转换任务执行的速度。此参数已调优,大部分场景不需要调整此参数,如无明确需求,不建议调整该参数。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# DATABUCKET_WRITE_POLICY

  • 参数类型:字符串

  • 默认值:ROUND-ROBIN

  • 取值范围/格式: ROUND-ROBIN,SEQUENTIAL

  • 参数说明:指定表空间下多个databucket的写入策略,建议使用默认值。

    • ROUND-ROBIN表示循环写多个databucket。

    • SEQUENTIAL表示写满一个databucket再写下一个。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# DATAFILE_IO_MODE

  • 参数类型:字符串

  • 默认值:DEFAULT

  • 取值范围/格式: DEFAULT,SYNC,DSYNC,DIRECT,ASYNC

  • 参数说明:指定数据文件IO的模式,配置不同的参数具有不同的IO表现,建议使用默认值。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# DATE_FORMAT

  • 参数类型:字符串

  • 默认值:yyyy-mm-dd

  • 取值范围/格式:[0001-01-01 00:00:00,9999-12-31 23:59:59] 支持的格式符:'YYYY'/'YYY'/'YY'/'Y' /'MM'/'MON'/'MONTH'/'DD'/'D'/'DAY'/'HH'/'HH12'/'HH24'/'MI'/'SS'/'AM'/'A.M.'/'PM'/'P.M.'

  • 参数说明:指定DATE类型的默认显示格式。

  • 修改立即生效:否

  • 会话级参数:是

  • 只读参数:否

  • 多节点是否要求一致:是

  • 引入版本:v22.1

# DB_BLOCK_CHECKSUM

  • 参数类型:字符串

  • 默认值:TYPICAL

  • 取值范围/格式:OFF,TYPICAL,FULL

  • 参数说明:指定页面的checkSum等级。OFF表示不校验页面checksum,TYPICAL表示磁盘读时校验、写时计算,FULL表示在TYPICAL的基础上,内存读也校验,内存写也重新计算。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# DB_BLOCK_SIZE

  • 参数类型:数值

  • 默认值:8192

  • 取值范围/格式:8K,16K,32K

  • 参数说明:数据块的大小,建议使用默认值。配置大数据块可以减少行连接的数量,提高数据库IO效率,但会带来数据空洞多、缓存区利用率低、并发冲突增多等问题。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:是

  • 引入版本:v22.1

# DB_BUCKET_NAME_CONVERT

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:主库路径1,备库路径1,主库路径2,备库路径2,…, 例如:DB_BUCKET_NAME_CONVERT = '/anchor/local_fs/','/standby/local_fs/','dbs/t2/ ','dbs/t2/s_'

  • 参数说明:指定主备local_fs类型bucket路径的转换规则,参数总长度必须小于16384。最多设置32对主备路径。建议配置为:DB_BUCKET_NAME_CONVERT = '节点1的YASDB_DATA','当前节点的YASDB_DATA','节点2的YASDB_DATA','当前节点的YASDB_DATA'…

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# DB_FILE_NAME_CONVERT

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:主库路径1,备库路径1,主库路径2,备库路径2,…,例如:DB_FILE_NAME_CONVERT = '/dbs/t1/','/dbs/t1/s','dbs/t2/ ','dbs/t2/s_'

  • 参数说明:指定主备数据文件路径的转换规则,参数总长度必须小于16384。最多设置32对主备路径。DB_FILE_NAME_CONVERT = '节点1的YASDB_DATA','当前节点的YASDB_DATA','节点2的YASDB_DATA','当前节点的YASDB_DATA'…

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# DBWR_BUFFER_SIZE

  • 参数类型:数值

  • 默认值:4M

  • 取值范围/格式:[4M,32M]

  • 参数说明:指定每个database writer线程私有buffer的大小。增加该线程的私有buffer大小可以提高数据库持久化数据的能力。建议参考环境磁盘能力配置此参数,该参数会影响双写文件的可用最小值导致启动或建库失败,近似公式参考CREATE DATABASE

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# DBWR_COUNT

  • 参数类型:数值

  • 默认值:2

  • 取值范围/格式:[1,16]

  • 参数说明:指定数据库数据刷磁盘线程的数量。增加该线程的数量可以提高数据库持久化数据的能力。建议参考环境磁盘能力配置此参数,该参数会影响双写文件的可用最小值导致启动或建库失败,近似公式参考CREATE DATABASE

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# DBWR_FLUSH_NEIGHBORS_COUNT

  • 参数类型:数值

  • 默认值:16

  • 取值范围/格式:[1,64]

  • 参数说明:指定数据库刷磁盘时进行脏块合并时寻找邻居脏块的个数,设置为1表示关闭脏块合并。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# DDL_LOCK_TIMEOUT

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:[0,1000000]

  • 参数说明:DDL加表锁等待超时的时间,单位为秒。等于上限时,表示无限等待。当在DDL语句内需要对表加锁但表已被锁时,会产生DDL加锁等待,若超时则报错。建议使用默认值。分布式部署中建议设置为60。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# DEFAULT_MCOL_TTL

  • 参数类型:数值

  • 默认值:3600

  • 取值范围/格式:[0,18446744073709551615]

  • 参数说明:LSC表可变数据的生命周期,单位为秒。建议使用默认值。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# DEFAULT_SWAP_TABLESPACE

  • 参数类型:字符串

  • 默认值:SWAP

  • 取值范围/格式:表空间名称

  • 参数说明:指定可使用的SWAP表空间为默认的SWAP表空间。共享集群部署中建议设置为本地SWAP表空间。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# DEFAULT_TABLE_TYPE

  • 参数类型:字符串

  • 默认值:HEAP

  • 取值范围/格式:HEAP,TAC,LSC

  • 参数说明:指定默认创建表的类型。建议使用默认值。分布式部署中建议设置为LSC。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# DEGREE_OF_PARALLEL

  • 参数类型:数值

  • 默认值:1

  • 取值范围/格式:[1,255]

  • 参数说明:指定默认的并行度,优先级低于hint,建议不超过CPU核数的一半,否则会导致性能严重劣化。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v22.1

# DIAG_ADR_ENABLED

  • 参数类型:布尔值

  • 默认值:TRUE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:自动诊断工具的开关

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# DIAGNOSTIC_DEST

  • 参数类型:字符串

  • 默认值:?/diag

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定自动故障诊断数据存放的路径,在共享集群或HA模式下各实例中该参数指向的路径不能重复。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# DIN_ADDR

  • 参数类型:字符串

  • 默认值:127.0.0.1:1690

  • 取值范围/格式:IPv4地址:端口 或 [IPV6地址]:端口

  • 参数说明:指定分布式场景下提供给内部网络访问的地址。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# DIN_HB_TIMEOUT

  • 参数类型:数值

  • 默认值:15

  • 取值范围/格式:[3,10800]

  • 参数说明:指定分布式场景下,内部网络心跳超时时间,单位为秒。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# DIN_RECONNECT_TIME

  • 参数类型:数值

  • 默认值:5000

  • 取值范围/格式:[1000,3600000]

  • 参数说明:指定分布式场景下,内部网络重连时间,单位为毫秒。参数已过时,新参数请查阅DIN_HB_TIMEOUT

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

  • 过时版本:V23.2

# DML_PARALLEL

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定是否允许DML并行执行,TRUE的情况下,hint指定的parallel才会生效。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v23.2

# DOUBLE_WRITE_ENABLED

  • 参数类型:布尔值

  • 默认值:TRUE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定是否开启双写机制,建议使用默认值。双写可以保证数据库在掉电等极端场景下,数据块不会被损坏,但打开双写会增加系统IO负担。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# DSINTERVAL_FORMAT

  • 该参数为预留参数

  • 参数类型:字符串

  • 默认值:dd hh24:mi:ss.ff

  • 取值范围/格式:[-100000000 00:00:00.000000,100000000 00:00:00.000000]

  • 参数说明:指定INTERVAL DAY TO SECOND类型的默认显示格式。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:是

  • 引入版本:v22.1

# ENABLE_ARCH_DATA_IGNORE_BACKUP

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:主备ARCH_DATA归档清理时是否忽略备份操作,该配置参数优先级高于ARCH_CLEAN_IGNORE_MODE

    • 该配置参数为TRUE时,不论ARCH_CLEAN_IGNORE_MODE配置如何,ARCH_DATA归档清理时均直接忽略备份但不忽略备库,ARCH_DATA归档文件发送给全部备库后即可清理。

    • 该配置参数为FALSE时,ARCH_DATA归档清理完全取决于ARCH_CLEAN_IGNORE_MODE配置,即与redo日志的归档文件清理同步。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

  • 过时版本:V23.2.3

# ENABLE_DISKCACHE

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:是否启用磁盘缓存。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# ENABLE_SEPARATE_DUTY

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定三权分立是否开启,TRUE表示开启三权分立,FALSE表示关闭三权分立。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# ENABLE_SLOW_LOG

  • 参数类型:字符串

  • 默认值:FALSE

  • 取值范围/格式:FALSE,TRUE

  • 参数说明:控制是否开启慢日志。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# ENCRYPT_ENGINE_TYPE

  • 参数类型:字符串

  • 默认值:OPENSSL

  • 取值范围/格式:OPENSSL、GMSSL、PCIE

  • 参数说明:加密引擎的类型。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# ENCRYPT_TYPE

  • 参数类型:字符串

  • 默认值:SSL

  • 取值范围/格式:SSL/TLCP

  • 参数说明:指定加密类型。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# EXTSERVER_CONNS

  • 参数类型:数值

  • 默认值:64

  • 取值范围/格式:[16,4096]

  • 参数说明:YEX_SERVER能建立的最大连接个数。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# GCS_TASK_COUNT

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:[0,128]

  • 参数说明:共享集群后台处理页面资源相关请求的线程数,值为0时,将根据操作系统参数计算出默认值。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# GLS_TASK_COUNT

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:[0,128]

  • 参数说明:共享集群后台处理DDL和锁资源相关请求的线程数,值为0时,将根据操作系统参数计算出默认值。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# GRC_TASK_COUNT

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:[0,64]

  • 参数说明:共享集群后台处理资源请求和排队的线程数,值为0时,将根据操作系统参数计算出默认值。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# GTS_BROADCAST_TIME

  • 参数类型:数值

  • 默认值:5

  • 取值范围/格式:[1,1000]

  • 参数说明:GTS同步时间,单位为毫秒。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# HA_ELECTION_AUTO_PRIMARY_SWITCH

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:在开启自动选主场景下,是否开启主节点在发现高优先级节点时主动降备,让高优先级节点升主的功能。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# HA_ELECTION_ENABLED

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定HA模式下,是否开启主备自动选主。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# HA_ELECTION_LEADER_LEASE_ENABLED

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:在开启自动选主场景下,是否开启主节点在未收到多数派备库心跳响应时主动降备的功能。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# HA_ELECTION_PRIORITY

  • 参数类型:数值

  • 默认值:1

  • 取值范围/格式:[0,100]

  • 参数说明:节点优先级,值越大表示其节点优先级越高。开启自动选主的场景下,节点的优先级越高,在保障数据安全的前提下会更优先成为主节点。当节点优先级为0时,该节点不会发起选举,即不会通过自动选主机制成为下一任主节点。支持在线修改该参数的配置,用户可根据自身业务系统情况自行设置。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# HA_ELECTION_TIMEOUT

  • 参数类型:数值

  • 默认值:9

  • 取值范围/格式:[1,1000]

  • 参数说明:选举和HA的心跳超时时间,节点组内需要统一配置。建议配置HA_ELECTION_TIMEOUT远大于 HA_HEARTBEAT_INTERVAL,防止网络闪断的情况下触发主备切换,单位为秒。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# HA_HEARTBEAT_INTERVAL

  • 参数类型:数值

  • 默认值:3

  • 取值范围/格式:[1,1000]

  • 参数说明:选举和HA的心跳间隔时间,节点组内需要统一配置,单位为秒。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# HA_SSL_ENABLE

  • 参数类型:布尔值

  • 默认值:OFF

  • 取值范围/格式:ON,OFF

  • 参数说明:HA专有监听,指定HA内部链路是否打开SSL加密。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# INSTANCE_NAME

  • 参数类型:字符串

  • 默认值:yasdb

  • 取值范围/格式:数据库名称

  • 参数说明:当前运行实例的名称。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

  • 参数类型:数值

  • 默认值:8

  • 取值范围/格式:[1,16]

  • 参数说明:共享集群实例间通信的通道数量,所有实例需保持一致。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# INTERCONNECT_MESSAGE_POOL

  • 参数类型:字符串

  • 默认值:1024:64;512:8800;128:16800;64:32800

  • 取值范围/格式:count:size;count:size;count:size;count:size,count取值范围[1,40960],size取值范围[32,65536]

  • 参数说明:共享集群的实例间通信消息池的配置信息,count表示每个pool可以容纳消息的数量;size表示pool中一条消息的最大值,单位为B。每个pool的总大小等于count * size,固定四组pool,需要配置每个pool的size不一样。设置参数值时,最后一组pool后的分号写或不写均可。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# INTERCONNECT_RECEIVE_TIMEOUT

  • 参数类型:数值

  • 默认值:5

  • 取值范围/格式:[0,3600]

  • 参数说明:ICS接收消息超时时间,单位为秒,0表示无限等待(不超时)。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# ISOLATION_LEVEL

  • 参数类型:字符串

  • 默认值:READ_COMMITTED

  • 取值范围/格式:CURRENT COMMITTED、SERIALIZABLE、READ COMMITTED

  • 参数说明:指定事务隔离级别,建议使用默认值。

  • 修改立即生效:否

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v22.1

# JOB_QUEUE_PROCESSES

  • 参数类型:数值

  • 默认值:16

  • 取值范围/格式:[0,1000]

  • 参数说明:指定执行后台任务的最大会话数。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# JVM_XMS

  • 参数类型:数值

  • 默认值:256M

  • 取值范围/格式:[8M,2T]

  • 参数说明:指定创建JVM时的-Xms参数,用于设置Java程序启动时占用的内存大小。不可大于JVM_XMX值。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# JVM_XMX

  • 参数类型:数值

  • 默认值:512M

  • 取值范围/格式:[8M,2T]

  • 参数说明:指定创建JVM时的-Xmx参数,用于设置java程序运行期间最大可占用的内存大小。不可小于JVM_XMS值。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# LARGE_POOL_SIZE

  • 参数类型:数值

  • 默认值:128M

  • 取值范围/格式:[8M,1T]

  • 参数说明:指定数据库内部大数据块的总大小。如无明显问题,建议使用默认值。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# LISTEN_ADDR

  • 参数类型:字符串

  • 默认值:0.0.0.0:1688

  • 取值范围/格式:IPv4地址:端口、[IPV6地址]:端口

  • 参数说明:服务端监听地址。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# LSC_DICTIONARY_CACHE_AUTOEXTEND

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定当LSC表数据插入阶段数据字典缓存使用达到上限时(报错YAS-03709),允许放开上限限制,继续分配数据字典缓存。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# LSNR_LOG

  • 参数类型:字符串

  • 默认值:ON

  • 取值范围/格式:ON,OFF

  • 参数说明:指定是否记录监听日志。ON表示开启,OFF表示关闭。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# MAX_PARALLEL_WORKERS

  • 参数类型:数值

  • 默认值:32

  • 取值范围/格式:[1,MIN(MAX_SESSIONS - 64,4096)]

  • 参数说明:单机行存和分布式并行的worker池的worker数量,同时会消耗对应额度的会话资源配额,详情请查阅MAX_SESSIONS参数。

    在分布式部署中,并行线程数会根据SQL语句复杂程度变化。当SQL语句比较复杂,计划生成所需stage数量(计划中的PX SEND数量)超过配置的worker数量时,SQL执行将报错,此时需要调整本参数,提高线程数增强并行能力。具体需要调整的值可以根据当前环境中复杂语句生成计划的stage数量进行预估。

    取值范围非固定,受当前MAX_SESSIONS值影响,设置时需注意。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# MAX_PRIVATE_TEMP_TABLES

  • 参数类型:数值

  • 默认值:16

  • 取值范围/格式:[8,64]

  • 参数说明:指定每个会话可以创建的私有临时表上限。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# MAX_REACTOR_CHANNELS

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:[0,16]

  • 参数说明:当会话使用线程池时,控制REACTOR线程的数量,REACTOR线程负责为等待状态的连接分配空闲的线程。该值为0时,不使用线程池,每个连接分配一个线程。分布式部署中,CN只允许配置为线程池模式,该配置参数默认值为1;DN/MN上该配置参数不生效。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# MAX_RECURSION_DEPTH

  • 参数类型:数值

  • 默认值:1000

  • 取值范围/格式:[1,4294967295]

  • 参数说明:执行递归CTE时,该参数可用于限制递归查询的最大深度。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v23.2

# MAX_SESSIONS

  • 参数类型:数值

  • 默认值:1024

  • 取值范围/格式:[64 + MAX_PARALLEL_WORKERS,16384]

  • 参数说明:指定支持的最大会话资源数。在分布式部署中,推荐单个MN、DN上的配置 = 各个CN上配置之和。

    需消耗会话资源数的场景包括用户建立连接会话、并行执行以及部分数据库后台线程,并行执行需独占配置参数MAX_PARALLEL_WORKERS指定数量的会话资源,其他会话资源由用户连接与数据库后台线程共享使用,每一个后台线程消耗一个会话资源,与后台线程数量相关的配置参数包括RECOVERY_PARALLELISM、SCOL_REPL_WORKERS和MMS_DATA_LOADERS。

    MAX_SESSIONS参数的值会影响redo文件大小的最小值(其最小值计算公式请查阅ALTER DATABASE的add logfile中相关描述),若MAX_SESSIONS参数配置不合理将会报错提示redo文件大小的最小值并可能会导致数据库启动或建库报错。

    每个会话会占用一定大小的会话内存,包括WORK_AREA_HEAP_SIZE、线程堆栈大小等,因此连接数越多占用内存越大,需要合理规划MAX_SESSIONS以及关联参数的值。

    取值范围非固定,受当前MAX_PARALLEL_WORKERS值影响,设置时需注意。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# MAX_WORKERS

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:0 和 [8,16368]

  • 参数说明:当线程池启用后,该参数表示线程池中最大的线程数,当MAX_WORKERS设置为0时,实际取MAX_WORKERS值为CPU数 * 2,当MAX_WORKERS >= MAX_SESSIONS时,线程池关闭。分布式部署中,线程池一直开启,推荐单个MN、DN上的配置 = 各个CN上配置之和。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# MAX_WORKERS_PER_EXEC

  • 参数类型:数值

  • 默认值:8

  • 取值范围/格式:[2,128]

  • 参数说明:每个stage组允许消耗的最大线程数。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v23.2

# MMS_DATA_LOADERS

  • 参数类型:数值

  • 默认值:4

  • 取值范围/格式:[0,8]

  • 参数说明:指定内存映射表空间(MMS)预加载的线程数量,0表示关闭预加载,建议使用默认值。数据库启动时会在后台预加载内存映射表空间的数据,如果数据量较大,通过配置此参数可以提高加载的效率。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# MMS_USE_LARGE_PAGES

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定内存映射表空间(MMS)是否使用大页内存。大页可以提升部分场景下的数据库性能,但会增加操作系统的内存压力。如需使用大页内存,需要在操作系统配置大页内存并参考操作系统参数调整关闭透明大页。如果有MMS的性能需求,建议配置为TRUE。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# NATIONAL_CHARACTER_SET

  • 参数类型:字符串

  • 默认值:UTF16

  • 取值范围/格式:UTF16

  • 参数说明:指定数据库使用的国家字符集。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:是

  • 多节点是否要求一致:是

  • 引入版本:v22.2

# NLS_NUMERIC_CHARACTERS

  • 参数类型:字符串

  • 默认值:.,

  • 取值范围/格式:. 或 .,

  • 参数说明:指定数据库的小数点分隔符和千分位分隔符,第一个字符为指定的小数点分隔符,第二个字符为指定的千分位分隔符。配置文件中,参数值需要使用单引号包裹,例如'.,'。该参数对列存表不生效。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v23.2

# NODE_ID

  • 参数类型:字符串

  • 默认值:1-1:1

  • 取值范围/格式:32位的group id - 32位的node id : 16位的endpoint

  • 参数说明:部署时由yasom自动配置,不允许修改。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:是

  • 引入版本:v22.1

# OM_ELECTION_ENABLE

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:表示是否启用yasom仲裁选主,正常情况下该配置参数由yasom自动维护,不得随意手动修改。

    • yasom自动维护:开启yasom仲裁选主时,该参数会自动被设置为TRUE。正常关闭yasom仲裁选主时,该参数会自动被设置为FALSE。

    • 特殊情况下需手动修改:强制关闭yasom仲裁选主后,可能部分节点的参数未被及时重置,此时需要用户手动重置该参数为FALSE,否则该节点启动时可能因无法确认主备角色而启动失败。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# OPEN_CURSORS

  • 参数类型:数值

  • 默认值:310

  • 取值范围/格式:[0,65535]

  • 参数说明:指定每个会话可打开的游标数上限。若该值设置为0,数据库将无法启动。修改该参数不会影响已经打开的游标。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# OPTIMIZER_DYNAMIC_SAMPLING

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:[0,7]区间的整数

  • 参数说明:优化器生成执行计划时,如果发现统计信息无效,会触发动态收集,通过此参数可以控制收集的级别。

    • 参数值为0表示不使用动态收集。

    • 参数值n为1 - 6表示无统计信息时采样2(n+4)个数据块,例如参数值为1表示无统计信息时采样32个数据库。

    • 参数值为7表示全量收集。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v22.2

# PACKET_SEND_TIMEOUT

  • 参数类型:数值

  • 默认值:600

  • 取值范围/格式:[1,86400]

  • 参数说明:指定服务端发送报文时的阻塞超时时间,单位为秒。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v23.2

# PASSWORD_FILE

  • 参数类型:字符串

  • 默认值:?/instance/yasdb.pwd

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定密码文件的路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# QUERY_REWRITE_ENABLED

  • 参数类型:字符串

  • 默认值:FALSE

  • 取值范围/格式:FALSE、TRUE、FORCE

  • 参数说明:是否使用物化视图的查询重写。

    • FALSE表示不使用查询重写。

    • TRUE表示启用优化器的查询重写功能并根据优化器的Cost成本在原语句与重写语句间选择更优计划。

    • FORCE表示启用优化器的查询重写功能并指示优化器强制使用物化视图重写查询。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v23.1

# QUORUM_SYNC_STANDBYS

  • 参数类型:字符串

  • 默认值:MAJORITY

  • 取值范围/格式:'ANY syncNum (standby_name1, standby_name2, …)'、'ANY syncNum (*)'或'MAJORITY'

  • 参数说明:最大保护模式下备库同步参数,不能为空(共享集群下该参数不生效)。若开启自动选主,组内主备库配置值必须要一致,否则会出现数据库不一致问题。需REQUIRED_SYNC_STANDBYS与QUORUM_SYNC_STANDBYS都满足时,主库才可以提交事务。

    • MAJORITY:表示至少需N/2个备库(即多数派)同步redo后,满足主库提交事务的条件,其中N为所有节点(包含主库)的数量。

    • ANY syncNum (备库列表):表示达到syncNum个数的备库同步redo后,满足主库提交事务的条件。各参数配置要求如下:

      • ANY:必须大写且不能省略。

      • syncNum的值:不能为零且不能大于()列表中的备库个数。

      • 备库列表:不能为空,长度不超过32个字符。*表示所有备库,如需直接罗列备库列表,格式为standby_name1, standby_name2, …,必须使用真实的备库名称且不能重复。

      QUORUM_SYNC_STANDBYS='ANY 2 (s1, s2, s3)'表示在s1(备库名称)、s2、s3三个备库中有任意2个备库同步redo后,才满足主库提交事务的条件。

      QUORUM_SYNC_STANDBYS='ANY 2 (*)'表示在所有备库中有2台备库同步redo后,才满足主库提交事务的条件。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# RECOVERY_PARALLELISM

  • 参数类型:数值

  • 默认值:16

  • 取值范围/格式:[0,128]

  • 参数说明:指定启动redo日志回放工作线程(RCY_REPL)的数量,0表示不使用并行回放。启动更多的线程可以提高回放速度,当数据库重启速度慢或备库回放速度比redo日志接收速度慢时,可适当提高该参数。但启动更多线程会消耗更多CPU,建议该值不超过CPU核数,RCY_REPL线程数量只能等于2n,当参数值不等于2n时不会报错但会向下取值为最大的2n

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# RECYCLEBIN_ENABLED

  • 参数类型:布尔值

  • 默认值:OFF

  • 取值范围/格式:ON,OFF

  • 参数说明:指定回收站功能是否打开。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# REDO_BUFFER_PARTS

  • 参数类型:数值

  • 默认值:8

  • 取值范围/格式:[1,32]

  • 参数说明:REDO_BUFFER的划分个数,不同session的日志写入不同的REDO_BUFFER段以便减少并发冲突,建议使用默认值。该参数与REDO_BUFFER_SIZE关联使用,最小的REDO_BUFFER_SIZE要大于(32 * DB_BLOCK_SIZE * REDO_BUFFER_PARTS + 1M),若不满足该公式(该公式为近似值),启动数据库有可能会报错。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# REDO_BUFFER_SIZE

  • 参数类型:数值

  • 默认值:64M

  • 取值范围/格式:[4M,128M]

  • 参数说明:redo刷盘的内存大小,单位为字节,建议使用默认值。该参数和redo文件大小相关,配置不合理可能会导致数据库启动或建库报错。最小的redo文件的详细计算公式可参考ALTER_DATABSE

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# REDO_FILE_NAME_CONVERT

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:'主库路径1','备库路径1','主库路径2','备库路径2',…,例如:REDO_FILE_NAME_CONVERT = '/dbs/t1/','/dbs/t1/s','dbs/t2/','dbs/t2/s_',…

  • 参数说明:指定主备redo文件路径的转换规则,参数总长度必须小于16384,最多设置32对主备路径。建议配置为'服务器1的YASDB_DATA','当前服务器的YASDB_DATA','服务器2的YASDB_DATA','当前服务器的YASDB_DATA',…

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# REDOFILE_IO_MODE

  • 参数类型:字符串

  • 默认值:DSYNC

  • 取值范围/格式:DSYNC、SYNC、DIRECT、DEFAULT

  • 参数说明:指定redo文件IO的模式,配置不同的参数具有不同的IO表现。建议使用DSYNC或DIRECT。使用DEFAULT性能最佳,但服务器或存储设备掉电会丢失数据,请慎用。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# REPLICATION_ADDR

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:IPv4地址:端口 或 [IPV6地址]:端口

  • 参数说明:主备消息链路监听地址,IPv4地址不允许配置为0.0.0.0。主备模式下,如果不设置该参数将直接复用LISTEN_ADDR的监听地址,建议配置为与LISTEN_ADDR不同的监听地址,以便提升HA复制性能和稳定性。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# REQUIRED_SYNC_STANDBYS

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:'standby_name1, standby_name2, …'或'*'

  • 参数说明:最大保护模式下备库同步参数,长度不超过32个字符,格式为'standby_name1, standby_name2, …''*',若采用standby_name格式必须使用真实的备库名称且不能重复,'*'表示当前所有备库。在共享集群部署下,所有实例的该参数配置必须完全一致。若开启自动选主,组内主备节点配置值必须要一致,否则会出现数据库不一致的问题。需REQUIRED_SYNC_STANDBYS和QUORUM_SYNC_STANDBYS都满足时,事务才可以提交。

    例如,REQUIRED_SYNC_STANDBYS='s4, s5'表示s4(备库名称)和s5两个备库都同步redo后,才满足主库提交事务的条件。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# RESOURCE_MANAGER_PLAN

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:已创建的资源计划名称,但不能为内置资源计划'TOALL'和'SYS_GROUP',长度不超过64个字节。

  • 参数说明:指定活动资源计划,关联到该计划的指令均生效。该参数需集群内各节点保持一致,建议通过yasboot工具进行修改,详细参数说明请查阅yasboot clutser 指定新的活动资源计划后,同样会动态调整SYS_GROUP组的共享资源(MGMT_P1),具体调整方式请查阅DBMS_RESOURCE_MANAGER中CREATE_PLAN_DIRECTIVE相关介绍。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2.3

# RSRC_MODE

  • 参数类型:字符串

  • 默认值:NONE

  • 取值范围/格式:NONE, CPU, MEM, ALL

  • 参数说明:资源管理功能开关,目前仅在单机部署和分布式部署中才生效。

    • NONE:表示不开启任何资源类型资源的管理

    • CPU:表示开启对CPU资源的隔离及管理

    • MEM:表示开启对用户内存资源的隔离及管理

    • ALL:表示同时开启CPU和用户内存资源的隔离及管理

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:是

  • 引入版本:v23.2

# RUN_LOG_FILE_COUNT

  • 参数类型:数值

  • 默认值:10

  • 取值范围/格式:[2,10000]

  • 参数说明:指定运行日志文件同时存在的个数。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# RUN_LOG_FILE_PATH

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定运行日志文件存放的路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# RUN_LOG_FILE_SIZE

  • 参数类型:数值

  • 默认值:20M

  • 取值范围/格式:[1M,4G]

  • 参数说明:指定每个运行日志文件的大小,超过该值时形成归档并创建新的运行日志文件。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# RUN_LOG_LEVEL

  • 参数类型:字符串

  • 默认值:INFO

  • 取值范围/格式:OFF,FATAL,ERROR,WARN,INFO,DEBUG,TRACE,ALL

  • 参数说明:指定运行日志级别。

    • OFF:关闭日志

    • FATAL:致命错误产生的日志

    • ERROR:一般错误产生的日志

    • WARN:告警类错误产生的日志

    • INFO:正常运行日志

    • DEBUG: 调试日志

    • TRACE: 追踪日志

    • ALL:开启所有日志

    从前到后,日志等级依次增高,高级别包含低级别日志。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SANDBOX_STANDBY

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定备库是否为沙箱备库,仅在备库上生效。沙箱备库下可以手动注册归档日志且沙箱备库拒绝主库连接。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# SCOL_CACHEABLE_SCAN_ROWS

  • 参数类型:数值

  • 默认值:18446744073709551615

  • 取值范围/格式:[0,18446744073709551615]

  • 参数说明:LSC表使用稳态数据缓存区的最大扫描记录数,如果查询计划评估扫描记录数超过该值,该扫描读取的数据不会写入稳态数据缓冲区。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SCOL_DATA_BUFFER_SIZE

  • 参数类型:数值

  • 默认值:128M

  • 取值范围/格式:[128M,2T]

  • 参数说明:指定LSC存储引擎使用的数据缓存区的大小。缓存区容量越大,数据库整体性能越好。容量过小会产生频繁的数据块换入换出,建议数据缓存区配置至少为1G。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SCOL_DATA_PRELOADERS

  • 参数类型:数值

  • 默认值:2

  • 取值范围/格式:[0,256]

  • 参数说明:LSC存储引擎使用的后台预读线程个数。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SCOL_DISK_CACHEABLE_SCAN_ROWS

  • 参数类型:数值

  • 默认值:18446744073709551615

  • 取值范围/格式:[0,18446744073709551615]

  • 参数说明:LSC表使用磁盘缓存的最大扫描记录数,如果查询计划评估扫描记录数超过该值,该扫描读取的数据不会写入磁盘缓存。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# SCOL_REPL_BUFFER_SIZE

  • 参数类型:数值

  • 默认值:8M

  • 取值范围/格式:[2M,128M]

  • 参数说明:指定稳态切片文件同步缓存buffer大小。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# SCOL_REPL_WORKERS

  • 参数类型:数值

  • 默认值:4

  • 取值范围/格式:[1,32]

  • 参数说明:指定稳态切片文件同步的工作线程数,如果网速够快可调大此配置提高同步速度。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# SCOL_SLICE_ROWS

  • 参数类型:数值

  • 默认值:8M

  • 取值范围/格式:[8M,128M]

  • 参数说明:指定稳态切片文件的数据上限,该配置参数只允许调大。切片文件合并操作会以此配置为参考,如果希望切片文件更大,可调大此配置。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# SCOL_WRITE_CACHE_POLICY

  • 参数类型:字符串

  • 默认值:WRITE_BACK

  • 取值范围/格式:WRITE_THROUGH,WRITE_BACK

  • 参数说明:指定LSC表生成稳态切片格式时的写入策略。WRITE_THROUGH表示直接写文件,WRITE_BACK表示先写入Cache,待Cache写满或写入完成时再刷到文件。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.1

# SECURE_FILE_PRIV

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式,路径中不允许使用'../',如果是'?', '.', './'形式,将设置为YASDB_DATA目录

  • 参数说明:用于指定部分功能的安全目录,未指定或指定为空串时相应功能不可用。安全目录的使用场景如下:

    • 调用UTL_FILE高级包读/写文件。

    • 通过yasql工具执行LOAD DATA语句导入文件。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# SESSION_BULKLOAD_MAX_MEM_PERCENT

  • 参数类型:数值

  • 默认值:100

  • 取值范围/格式:[1,100]

  • 参数说明:指定进行BULKLOAD导入时,单个导入任务使用的物化内存占BULKLOAD_MAX_MEM_PERCENT的上限百分比。如果当前导入任务的内存换出严重,建议适当调大此参数;如果当前导入任务没有内存换出,可适当调小此参数,调大导入并行度。导入过程中一个导入线程的最大可用内存按如下公式配置:COLUMNAR_MATERIAL_PERCENT * COLUMNAR_VM_BUFFER_SIZE * BULKLOAD_MAX_MEM_PERCENT * SESSION_BULKLOAD_MAX_MEM_PERCENT。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# SESSION_MAX_OPEN_FILES

  • 参数类型:数值

  • 默认值:50

  • 取值范围/格式:[1,100]

  • 参数说明:指定会话中UTL_FILE高级包最多可以打开的文件数。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SHARE_POOL_SIZE

  • 参数类型:数值
  • 默认值:256M

  • 取值范围/格式:[256M,64T]

  • 参数说明:指定共享缓存区使用的内存大小。执行计划缓存区、数据字典缓存区、锁缓存区、游标缓存区和分布式缓存区共享此区域内存,共享缓存区大小减去锁缓存区大小和游标缓存区大小后再按百分比分配执行计划缓存区、数据字典缓存区和分布式缓存区的大小。如果并发业务较多,建议调大此参数。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# SLOW_LOG_FILE_NAME

  • 参数类型:字符串

  • 默认值:slow.log

  • 取值范围/格式:xxx.log

  • 参数说明:慢日志文件名。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SLOW_LOG_FILE_PATH

  • 参数类型:字符串

  • 默认值:?/log/slow

  • 取值范围/格式:标准目录路径格式

  • 参数说明:用于指定慢日志文件存储目录,该路径默认存储为YASDB_DATA/log/slow。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SLOW_LOG_OUTPUT

  • 参数类型:字符串

  • 默认值:FILE

  • 取值范围/格式:FILE、TABLE

  • 参数说明:慢日志内容的输出方式。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SLOW_LOG_SQL_MAX_LEN

  • 参数类型:数值

  • 默认值:2000

  • 取值范围/格式:[20,2000]

  • 参数说明:慢日志记录的SQL语句的最大长度值,单位为字节,超过的部分不记录。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SLOW_LOG_TIME_THRESHOLD

  • 参数类型:数值

  • 默认值:1000

  • 取值范围/格式:[0,4294967295]

  • 参数说明:时间阈值,单位为毫秒。超过该值的SQL语句会被视为慢SQL,记录到慢日志中。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SMM_ENABLE

  • 参数类型:字符串

  • 默认值:OFF

  • 取值范围/格式:[ON,OFF]

  • 参数说明:开机是否做安全函数自测

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# SQL_MAP

  • 参数类型:布尔值

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:SQLMAP开关。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SQL_PLUGIN

  • 参数类型:字符串

  • 默认值:NONE

  • 取值范围/格式:NONE,MySQL

  • 参数说明:SQL语法的支持范围,NONE表示只支持ORACLE的SQL语法,基本未对其他数据库的SQL语法进行特殊适配与支持。MySQL表示支持部分MySQL的SQL语法。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SSL_CERT_FILE

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定证书的路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SSL_DH_PARAM_FILE

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定DH参数的路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SSL_ENABLE

  • 参数类型:布尔值

  • 默认值:OFF

  • 取值范围/格式:ON,OFF

  • 参数说明:指定SSL是否打开。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# SSL_KEY_FILE

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定私钥的路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# STARTUP_ROLLBACK_PARALLELISM

  • 参数类型:数值

  • 默认值:8

  • 取值范围/格式:[1,16]

  • 参数说明:指定重启时回滚线程的数目。数据库启动阶段会对未结束的事务进行回滚,可配置回滚线程数目优化并发度,缩小重启回滚需要的时间。如果希望提升数据库重启速度,可以考虑调大此参数。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# STATISTICS_LEVEL

  • 参数类型:字符串

  • 默认值:TYPICAL

  • 取值范围/格式:BASIC、TYPICAL、ALL

  • 参数说明:信息统计的范围。

    • ALL表示统计算子级别的执行信息,例如行数、执行时间等信息;统计SQL的存储层执行信息,例如递归调用、读取的block数量等。

    • BASIC表示统计SQL的存储层执行信息,例如递归调用、读取的block数量等。

    • TYPICAL表示不仅统计SQL的存储层执行信息,例如递归调用、读取的block数量,也统计表的插入、更新、删除次数等。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 系统参数:是

  • 引入版本:v22.2

# STREAM_POOL_SIZE

  • 参数类型:数值
  • 默认值:0M

  • 取值范围/格式:[0M,64T]

  • 参数说明:YStream的内存池大小,日志解析业务内存均使用该内存池。默认值为0,表示不开启内存池。如果启用YStream服务,请将该值设置为[64M,64T]区间的有效值,否则连接YStream服务时报错该POOL没有空闲块。该配置支持配置文件设置和在线修改,在线扩大该值时不影响正在运行的YStream服务,在线缩小该值需停止所有YStream服务。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v23.2

# TAB_QUEUE_WINDOW_SIZE

  • 参数类型:数值

  • 默认值:4

  • 取值范围/格式:[1,1024]

  • 参数说明:指定会话内数据通道的窗口大小。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v22.2

# TIME_FORMAT

  • 该参数为预留参数

  • 参数类型:字符串

  • 默认值:hh24:mi:ss.ff

  • 取值范围/格式:[00:00:00.000000,23:59:59.999999],支持的格式符:'HH'/'HH12'/'HH24'/'MI'/'SS'/'AM'/'A.M.'/'PM'/'P.M.'/'FF'/'FF1'/'FF2'/'FF3'/'FF4'/'FF5'/'FF6'/'FF7'/'FF8'/'FF9'

  • 参数说明:指定TIME类型默认显示格式。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:是

  • 引入版本:v22.1

# TIMESTAMP_FORMAT

  • 该参数为预留参数

  • 参数类型:字符串

  • 默认值:yyyy-mm-dd hh24:mi:ss.ff

  • 取值范围/格式:[0001-01-01 00:00:00.000000,9999-12-31 23:59:59.999999],支持的格式符:'YYYY'/'YYY'/'YY'/'Y'/'MM'/'MON'/'MONTH'/'DD'/'D'/'DAY'/'HH'/'HH12'/'HH24'/'MI'/'SS'/'AM'/'A.M.'/'PM'/'P.M.'/'FF'/'FF1'/'FF2'/'FF3'/'FF4'/'FF5'/'FF6'/'FF7'/'FF8'/'FF9'

  • 参数说明:指定TIMESTAMP类型的默认显示格式。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:是

  • 引入版本:v22.1

# TLCP_CACERT_FILE

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定CA证书的路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# TLCP_CERT_FILE

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定证书的路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# TLCP_ENCKEY_FILE

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定加密证书的路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# TLCP_PASS_FILE

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定密码配置文件路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# TLCP_SIGNKEY_FILE

  • 参数类型:字符串

  • 默认值:''

  • 取值范围/格式:标准目录路径格式

  • 参数说明:指定签名证书的路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# TRANSACTION_LOCK_TIMEOUT

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:[0,1000000]

  • 参数说明:事务等待超时时间,单位为秒,0表示无限等待。当发生不同事务修改同一行冲突时,会产生事务等待,若超时则报错。建议使用默认值。分布式部署中建议设置为300。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# TRANSFORMER_MAX_MEM_PERCENT

  • 参数类型:数值

  • 默认值:80

  • 取值范围/格式:[1,100]

  • 参数说明:指定后台转换、合并等任务使用的物化内存占COLUMNAR_VM_BUFFER_SIZE的上限百分比。如果后台任务的内存换出严重,建议适当调大此参数。所有后台任务的最大可用内存按如下公式配置:COLUMNAR_MATERIAL_PERCENT * COLUMNAR_VM_BUFFER_SIZE * TRANSFORMER_MAX_MEM_PERCENT。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# UKEY_AUDIT_ADMIN_PUBLIC_KEY_FILE

  • 参数类型:字符串

  • 默认值:?/instance/audit_admin.pub

  • 取值范围/格式:文件的路径

  • 参数说明:指定UKEY认证的AUDIT_ADMIN公钥文件路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# UKEY_DBA_PUBLIC_KEY_FILE

  • 参数类型:字符串

  • 默认值:?/instance/dba.pub

  • 取值范围/格式:文件的路径

  • 参数说明:指定UKEY认证的DBA公钥文件路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# UKEY_SECURITY_ADMIN_PUBLIC_KEY_FILE

  • 参数类型:字符串

  • 默认值:?/instance/security_admin.pub

  • 取值范围/格式:文件的路径

  • 参数说明:指定UKEY认证的SECURITY_ADMIN公钥文件路径。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v23.2

# UNDO_RETENTION

  • 参数类型:数值

  • 默认值:300

  • 取值范围/格式:[0,4294967295]

  • 参数说明:指定undo block从事务提交那一刻开始被保留的时间,单位为秒。超过本参数规定的时间时,事务对应的undo block可被随意复用,不再保留。如果undo表空间资源不足无法分配任何block,也可能会复用已提交事务未超过保留时间的block。有长查询时,建议调大此参数。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# UNDO_SHRINK_ENABLED

  • 参数类型:布尔值

  • 默认值:TRUE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:指定是否开启undo后台自动平衡功能。undo balance功能在后台线程定时将undo segment上的undo block回收至undo表空间,优化undo block分配和使用状况。如果未发现性能问题,建议使用默认值。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# UNDO_SHRINK_INTERVAL

  • 参数类型:数值

  • 默认值:3600

  • 取值范围/格式:[0,4294967295],且必须大于UNDO_RETENTION

  • 参数说明:后台undo balance功能的时间间隔。如果未发现性能问题,建议使用默认值。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# UNIFIED_AUDITING

  • 参数类型:字符串

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:统一审计开关。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.2

# USE_LARGE_PAGES

  • 参数类型:字符串

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE、ONLY

  • 参数说明:配置数据库是否使用大页内存。FALSE表示不使用大页内存,ONLY表示只使用大页内存,TRUE表示大页不足时使用普通内存。大页内存可以提升部分场景下的数据库性能,但会增加操作系统的内存压力。如果数据库要使用大页内存,需要在操作系统配置大页内存并参考操作系统参数调整关闭透明大页,否则YashanDB可能被系统异常终止。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 引入版本:v22.1

# USE_NATIVE_TYPE

  • 参数类型:布尔值

  • 默认值:TRUE

  • 取值范围/格式:TRUE、FALSE

  • 参数说明:配置数据库是否使用原生数据类型。TRUE表示使用原生数据类型,FALSE表示使用Oracle兼容类型。当参数值为FALSE时,数据库存在以下表现:

    • 在建表DDL语句中,TINYINT、SMALLINT、INTEGER、BIGINT类型会被解析成NUMBER(38,0),FLOAT类型会被解析成NUMERIC_FLOAT类型并支持设置精度,原生FLOAT类型改为BINARY_FLOAT。

    • 在SELECT语句中,如果最外层投影列的类型是TINYINT、SMALLINT、INTEGER、BIGINT,则会隐式的包裹一层TO_NUMBER函数,将最终结果转换为NUMBER(38,0)。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:是

  • 引入版本:v23.2

# USE_STORED_OUTLINES

  • 参数类型:字符串

  • 默认值:FALSE

  • 取值范围/格式:TRUE、FALSE、或字符串长度不能大于64个

  • 参数说明:设置OUTLINE对应的类别名称。FALSE表示不使用OUTLINE,TRUE表示只使用默认类别为DEFAULT的OUTLINE,其他字符串值表示先按给定的类别名查找,匹配不上再按默认类别为DEFAULT的类别名查找。根据给定类别名查找SQL对应的HINTS,查找到的HINTS在生成执行计划时产生影响,维护SQL执行计划的稳定性。

  • 修改立即生效:是

  • 会话级参数:是

  • 只读参数:否

  • 引入版本:v23.1

# VM_BUFFER_SIZE

  • 参数类型:数值

  • 默认值:128M

  • 取值范围/格式:[8M,2T]

  • 参数说明:指定SQL标准计算使用的内存大小。当计算中排序、物化、JOIN等涉及的数据量较多时,建议调大此参数,可以增加计算性能。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# WORK_AREA_HEAP_SIZE

  • 参数类型:数值

  • 默认值:512K

  • 取值范围/格式:[128K,4M]

  • 参数说明:指定会话内执行内存区(堆方式)大小,推荐使用默认值。分布式部署中建议设置为2M。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# WORK_AREA_POOL_SIZE

  • 参数类型:数值

  • 默认值:16M

  • 取值范围/格式:[4M,1T]

  • 参数说明:指定全局执行内存区(堆方式)大小,推荐使用默认值。分布式部署中建议设置为128M。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v22.1

# WORK_AREA_STACK_SIZE

  • 参数类型:数值

  • 默认值:1024K

  • 取值范围/格式:[1024K,64M]

  • 参数说明:指定会话内执行内存区(栈方式)大小,推荐使用默认值。出于版本兼容性考虑,该参数允许被设置为小于默认值的值,但实际将按照默认值生效。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:否

  • 引入版本:v23.1

# YASFS_DATA_DIR

  • 参数类型:字符串

  • 默认值:+DG0

  • 取值范围/格式:+DiskGroup/full/path/only

  • 参数说明:指定集群模式下默认数据文件位置,目前必须为YFS绝对路径(以+开头)。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:是

  • 引入版本:v23.1

# YMINTERVAL_FORMAT

  • 该参数为预留参数

  • 参数类型:字符串

  • 默认值:yy-mm

  • 取值范围/格式:[-178000000-00,178000000-00]

  • 参数说明:指定INTERVAL YEAR TO MONTH类型的默认显示格式。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

  • 多节点是否要求一致:是

  • 引入版本:v22.1

pdf-btn 下载文档
copy-btn 复制链接