华为云用户手册

ts_adaptive_threads 参数说明：是否开启时序Compaciton功能中的consumer线程自增长。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on：表示打开时序数据库Compaciton功能Consumer线程自增长。 off：表示关闭时序数据库Compaciton功能Consumer线程自增长 默认值：off 当Compaction合并consumer性能不足时，可以开启线程自增长自动开启consumer满足合并性能。

hll_default_regwidth（废弃） 参数说明：该参数可以指定hll数据结构每个桶的位数，该值越大，hll所占内存越高。hll_default_regwidth和hll_default_log2m可以决定当前hll能够计算的最大distinct value。当前regwidth设为固定值，该参数不再使用。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，1~5。 默认值：5

ts_compaction_strategy 参数说明：时序数据库合并策略，需要以字符串形式输入5个参数分别是每次合并的最小part数量，每次合并的最大part数量，每次合并层次中间值，合并层次最大值，合并是否开启模糊合并。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串类型，字符串长度限制为15，第一个参数限制为2-5，第二个参数限制为4-10，第三个参数限制为4-12，第四个参数限制为7-20，最后一个参数限制为0-1。 默认值："3,6,6,12,0" 合并的策略决定了Compaciton消耗系统资源的大小，Compaction残留part的数量。

enable_agg_pushdown_for_ca 参数说明：在协同分析特性中，该参数控制是否将ForeignScan算子之上的Agg算子转化为Remote SQL发送给远端集群。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示将ForeignScan之上的Agg算子转化为Remote SQL。 off表示只将ForeignScan算子转化为Remote SQL。 默认值：on

ts_consumer_workers 参数说明：设置Compaction功能数据合并线程数。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，1～100。 默认值： 独立部署：30（60核CPU/480GB内存），16（32核CPU/256GB内存），8（16核CPU/128GB内存），4（8核CPU/64GB内存，4核CPU/32G内存），2（4核CPU/16G内存） 金融版（标准型）：30（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存），16（32核CPU/256GB内存），8（16核CPU/128GB内存），4（8核CPU/64GB内存） 企业版：30（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存），16（32核CPU/256GB内存），8（16核CPU/128GB内存），4（8核CPU/64GB内存） 金融版（数据计算型）：30（196核CPU/1536G内存，128核CPU/1024G内存，96核CPU/768G内存，72核CPU/576G内存）；16（64核CPU/512G内存，32核CPU/256G内存） 建议设置为CPU逻辑核心数一半。

enable_ts_compaction 参数说明：是否开启时序Compaction功能，即是否需要把多个数据小文件合并压缩成大文件。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on：表示打开时序数据库Compaction特性功能。 off：表示关闭时序数据库Compaction特性功能。 默认值：on 集群安装完毕后开启Compaction功能，后续使用中禁止关闭Compaction功能。

transparent_encrypt_kms_url 参数说明：该参数已废弃。它存储的是透明加密的数据库密钥获取地址，内容要求不可出现RFC3986标准外的字符，最大长度2047字节。格式为“kms://协议@KMS主机名1;KMS主机名2:KMS端口号/kms”，例如kms://https@linux175:29800/。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串 默认值：空

change_cluster_mode 参数说明：用于表示集群是否处于模式切换过程中，其中“模式切换”是指：一主两备集群切换为一主一备一日志集群，或一主一备一日志集群切换为一主两备集群，或一主一备一日志集群中备DN和日志DN互切。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~2147483647 0表示不处于集群模式切换过程中。 1表示处于集群模式切换过程中。 其他值无实际意义，效果等同于设置为0。 默认值：0 该参数用于控制“分布式备机读”功能是否正常可用。当设置为1时，“分布式备机读”功能将无法使用，请谨慎设置该参数。

enable_gpi_auto_update 参数说明：控制在分区DDL命令中是否默认更新Global索引。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。该参数必须在CN和DN设置为相同值，否则可能会导致Global索引功能异常。 取值范围：布尔型 on表示默认更新Global索引，此时分区DDL无论带不带UPDATE GLOBAL INDEX子句，都会更新Global索引。 off表示默认不更新Global索引，此时只有当分区DDL带UPDATE GLOBAL INDEX子句，才会更新Global索引。 默认值：off

max_concurrent_autonomous_transactions 参数说明：自治事务最大连接数，同一时间自治事务执行的最大并发数。当设置为0时，将无法执行自治事务。 该参数属于POSTMASTER类型参数，请参考表表1中对应设置方法进行设置。 取值范围：0-10000，理论最大值为10000，实际最大值为动态值，计算公式为“262143 - job_queue_processes - autovacuum_max_workers - max_inner_tool_connections - max_connections - AUXILIARY_BACKENDS - AV_LAUNCHER_PROCS”，job_queue_processes、autovacuum_max_workers、max_inner_tool_connections和max_connections的值取决于对应GUC参数的设置，AUXILIARY_BACKENDS为预留辅助线程数固定为20，AV_LAUNCHER_PROCS为预留autovacuum的launcher线程数固定为2。 默认值： 独立部署：80（60核CPU/480G内存）；40（32核CPU/256G内存）；20（16核CPU/128G内存）；10（8核CPU/64G内存，4核CPU/32G内存，4核CPU/16G内存） 金融版（标准型）： CN：200（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；150（96核CPU/768G内存）；120（80核CPU/640G内存，72核CPU/576G内存）；100（64核CPU/512G内存）；80 （60核CPU/480G内存）；40（32核CPU/256G内存）；20（16核CPU/128G内存）；10（8核CPU/64G内存） DN：200（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；150（96核CPU/768G内存）；120（80核CPU/640G内存，72核CPU/576G内存）；100（64核CPU/512G内存）；80 （60核CPU/480G内存）；40（32核CPU/256G内存）；20（16核CPU/128G内存）；10（8核CPU/64G内存） 企业版： CN：200（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；150（96核CPU/768G内存）；120（80核CPU/640G内存，72核CPU/576G内存）；100（80核CPU/512G内存，64核CPU/512G内存）；80（60核CPU/480G内存）；40（32核CPU/256G内存）；20（16核CPU/128G内存）；10（8核CPU/64G内存） DN：200（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；150（96核CPU/768G内存）；120（80核CPU/640G内存，72核CPU/576G内存）；100（80核CPU/512G内存，64核CPU/512G内存）；80（60核CPU/480G内存）；40（32核CPU/256G内存）；20（16核CPU/128G内存）；10（8核CPU/64G内存） 金融版（数据计算型）： CN：200（196核CPU/1536G内存，128核CPU/1024G内存）；150（96核CPU/768G内存）；120（72核CPU/576G内存）；100（64核CPU/512G内存）；40（32核CPU/256G内存） DN：200（196核CPU/1536G内存，128核CPU/1024G内存）；150（96核CPU/768G内存）；120（72核CPU/576G内存）；100（64核CPU/512G内存）；40（32核CPU/256G内存） 设置建议：根据实际业务需要和硬件配置设置此参数，建议不超过max_connections的1/10。若仅调大此参数，未同比例调整内存参数，业务压力大时，容易出现内存不足，报错提示“memory is temporarily unavailable”。 若升级过程中涉及此参数范围变更，并且在commit前修改了此参数，则如果执行升级回滚，需要将此参数调整至升级前允许的范围，否则可能导致数据库无法启动。

server_version_num 参数说明：报告服务器版本号(整数形式)。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。该参数继承自PostgreSQL内核，表示当前数据库内核兼容PostgreSQL对应的server_version_num版本，无实际含义，为保持北向对外工具接口的生态兼容性(工具连接时查询)，保留该参数。 取值范围：整型 默认值：90204

transparent_encrypted_string 参数说明：该参数已废弃。它存储的是透明加密的一个样本串，使用数据库加密密钥加密固定串“TRANS_ENCRYPT_SAMPLE_STRING”后的密文，用来校验二次启动时获取的DEK是否正确。如果校验失败，那么CN、DN将拒绝启动。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，设置为空表示整个集群为加密。 默认值：空 请勿手动设置该参数，设置不当将导致集群不可用。

enable_upgrade_merge_lock_mode 参数说明：当该参数设置为on时，通过提升deltamerge内部实现的锁级别，避免和update/delete并发操作时的报错。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on，提升deltamerge内部实现的锁级别，并发执行deltamerge和update/delete操作时，一个操作先执行，另一个操作被阻塞，在前一个操作完成后，后一个操作再执行。 off，在对表的delta table的同一行并发执行deltamerge和update/delete操作时，后一个对同一行数据更新的操作会报错退出。 默认值：off

use_elastic_search 参数说明：使能统一审计发送日志至Elastic Search系统, enable_security_policy打开且本参数打开后，统一审计日志会通过http(https)传递至Elastic Search系统（默认使用https安全协议）。此参数打开后需要保证elastic_search_ip_addr对应的es服务可正常连通，否则进程启动失败。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型。 on：使能统一审计日志发送至Elastic Search。 off：关闭统一审计日志发送至Elastic Search。 默认值：off

block_encryption_mode 参数说明：aes_encrypt和aes_decrypt函数进行加解密时使用的块加密模式。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：枚举类型，有效值为aes-128-cbc, aes-192-cbc，aes-256-cbc，aes-128-cfb1，aes-192-cfb1，aes-256-cfb1，aes-128-cfb8，aes-192-cfb8，aes-256-cfb8，aes-128-cfb128，aes-192-cfb128，aes-256-cfb128，aes-128-ofb，aes-192-ofb，aes-256-ofb。其中aes表示加/解密算法，128/192/256表示密钥长度（单位：bit），cbc/cfb1/cfb8/cfb128/ofb表示块加/解密模式。 默认值：aes-128-cbc

server_version 参数说明：报告服务器版本号(字符串形式)。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。该参数继承自PostgreSQL内核，表示当前数据库内核兼容PostgreSQL对应的server_version版本，无实际含义，为保持北向对外工具接口的生态兼容性(工具连接时查询)，保留该参数。该参数不建议使用，可通过函数opengauss_version()获取内核版本信息。 取值范围：字符串 默认值：9.2.4

elastic_search_ip_addr 参数说明：Elastic Search系统IP地址 ，使用https协议格式为：https://ip:port:username；使用http协议格式为：http://ip:port。其中，ip为Elastic Search服务器的IP，port为Elastic Search HTTP通信的侦听端口，范围为9200 - 9299，username为用户在Elastic Search注册账号所使用的用户名，初始用户为elastic。使用https协议需要配置相关证书，详见《安全加固指南》中“统一审计“章节。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串。 默认值：''

streaming_router_port 参数说明：指定流引擎特性通信占用的端口，需重启生效，端口在流引擎打开时占用。通常由OM运维时自动设置，不推荐用户进行修改。 如果用户必须进行修改，则需要连同port主端口进行一起修改，需要保证 streaming_router_port - port 偏移量与OM自动配置的相同，该偏移值不允许修改。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0 ~ 65535 初始值由OM在运维时根据集群部署形态进行自动设置，一主多备形态下为port+6，主备从形态下与节点上的DN数量相关。 如果取值0，则使用 port（主端口GUC）+6 作为实际占用端口。 默认值：port（主端口GUC）+6

query_log_file（废弃） 参数说明：GUC参数enable_slow_query_log设置为ON，表示需要将慢查询记录写进日志文件中，query_log_file决定服务器慢查询日志文件的名称，仅sysadmin用户可以访问。通常日志文件名是按照strftime模式生成，因此可以用系统时间定义日志文件名，用%转义字符实现，在该版本中已废弃。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 建议使用%转义字符定义日志文件名称，否则难以对日志文件进行有效的管理。 取值范围：字符串 默认值：slow_query_log-%Y-%m-%d_%H%M%S.log

track_stmt_retention_time 参数说明：组合参数，控制全量/慢SQL记录的保留时间。以60秒为周期读取该参数，并执行清理超过保留时间的记录，仅sysadmin用户可以访问。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符型，该参数分为两部分，形式为'full sql retention time, slow sql retention time'： full sql retention time为全量SQL保留时间，取值范围为0 ~ 86400，单位为秒。 slow sql retention time为慢SQL的保留时间，取值范围为0 ~ 604800，单位为秒。 默认值：3600,604800

instr_unique_sql_count 参数说明：控制系统中unique sql信息实时收集功能。配置为0表示不启用unique sql信息收集功能。 该值由大变小将会清空系统中原有的数据重新统计(备机不支持此能力)；从小变大不受影响。 当系统中产生的unique sql信息（由dbe_perf.statement/dbe_perf.summary_statement统计）大于instr_unique_sql_count时，系统产生的unique sql信息不被统计。 在x86架构集中式部署下，硬件配置规格为32U256GB，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约3%。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~2147483647 默认值：200000

enable_instr_cpu_timer 参数说明：是否捕获sql执行的cpu时间消耗 。 在x86架构集中式部署下，硬件配置规格为32U256GB，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约3.5%。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on：表示捕获sql执行的cpu时间消耗。 off：表示不捕获sql执行的cpu时间消耗。 默认值：on

query_log_directory（废弃） 参数说明：enable_slow_query_log设置为on时，query_log_directory决定存放服务器慢查询日志文件的目录，仅sysadmin用户可以访问。它可以是绝对路径，或者是相对路径（相对于数据目录的路径），在该版本中已废弃。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 当配置文件中query_log_directory的值为非法路径时，会导致集群无法重新启动。 合法路径：用户对此路径有读写权限 非法路径：用户对此路径无读写权限 取值范围：字符串 默认值：安装时指定。

asp_log_directory 参数说明：asp_flush_mode设置为all或者file时，asp_log_directory决定存放服务器asp日志文件的目录。它可以是绝对路径，或者是相对路径（相对于数据目录的路径），仅sysadmin用户可以访问。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 当配置文件中asp_log_directory的值为非法路径时，会导致集群无法重新启动。 合法路径：用户对此路径有读写权限。 非法路径：用户对此路径无读写权限。 取值范围：字符串 默认值：安装时指定。

enable_stmt_track 参数说明：控制是否启用Full /Slow SQL特性。 在x86架构集中式部署下，硬件配置规格为32U256GB，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约1.2%。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on：表示开启Full /Slow SQL捕获 off：表示关闭Full /Slow SQL捕获 默认值：on

track_stmt_parameter 参数说明：开启track_stmt_parameter后，在statement_history中记录的执行语句不再进行归一化操作，可以显示完整SQL语句信息，辅助DBA进行问题定位；其中对于简单查询，显示完整语句信息；对于PBE语句，显示完整语句信息的同时，追加每个变量数值信息，格式为“query string；parameters:$1=value1,$2=value2,...”，该参数提供的目的是为用户呈现全量SQL信息，不受track_activity_query_size参数控制。对于PBE类型语句且走SQL Bypass逻辑时，参数直接下发到DN，故在CN查询statement_history无法获取完整语句数信息，同时由于DN无Query字符串信息，故在DN查询statement_history中也无法获取完整语句信息。 该参数属于SIGHUP类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型 on：表示开启显示完整SQL语句信息的功能。 off：表示关闭显示完整SQL语句信息的功能。 默认值：off

gtm_krb_server_keyfile 参数说明：kerberos服务端key文件所在位置，需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下，以keytab格式结尾，文件名与集群运行所在用户名相同。与上述gtm_authentication_type参数是配对的，当gtm_authentication_type参数修改为gss时，该参数也必须配置为正确路径，否则将影响集群状态。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串类型 默认值：''

gtm_option 参数说明：GTM模式选项，用来指定选用的GTM模式，需要在GTM，CN，DN所有实例上配置，配置的值要一致，共三种模式：GTM模式，GTM-Lite模式，GTM-Free模式（参见《特性指南》的“GTM模式”章节）。其中GTM模式和GTM-Lite模式要在enable_gtm_free参数设置为off的情况下生效，当前版本暂不支持安装好的集群进行不同GTM模式之间的切换。 取值范围：整型，0~2，0表示GTM模式，1表示GTM-Lite模式，2表示GTM-Free模式。请参考表1中对应设置方法进行设置。 默认值：1

gtm_authentication_type 参数说明：GTM模块端口认证方式，trust表示未配置端口认证，gss表示采用kerberos端口认证。必须注意的是：只有当kerberos服务端和客户端成功安装后才能修改为gss，否则GTM模块无法正常通信，将影响集群状态。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：枚举类型，有效值有trust, gss。 默认值：trust

alarm_component 参数说明：在对告警做上报时，会进行告警抑制，即同一个实例的同一个告警项在alarm_report_interval（默认值为10s）内不做重复上报。在这种情况下设置用于处理告警内容的告警组件的位置。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串 若前置脚本gs_preinstall中的--alarm-type参数设置为5时，表示未对接第三方组件，告警写入system_alarm日志，此时GUC参数alarm_component的取值为：/opt/huawei/snas/bin/snas_cm_cmd。 若前置脚本gs_preinstall中的--alarm-type参数设置为1时，表示对接第三方组件，此时GUC参数alarm_component的值为第三方组件的可执行程序的绝对路径。 默认值：/opt/huawei/snas/bin/snas_cm_cmd