华为云用户手册

global_syscache_threshold 参数说明：全局系统缓存内存最大占用大小，使用时需要打开enable_global_syscache参数。 参数类型：整型 参数单位：kB 取值范围：16384~1073741824 默认值：163840 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：热点DB个数和线程个数的最小值乘以每个DB分配的内存大小，即global_syscache_threshold = min(count(hot dbs)，count(threads)) * memofdb。 热点DB数即访问较为频繁的数据库，线程数在线程池模式下取线程池线程个数和后台线程个数之和，非线程池模式不需要计算这个值，直接使用热点DB数。 memofdb即平均每个db应该分配的内存，每个DB的底噪内存是2M，平均每增加一个表或者索引，增加11k内存。 如果设置的值过小，会导致内存频繁淘汰，内存存在大量碎片无法回收，导致内存控制失效。

resilience_threadpool_reject_cond 参数说明：用于控制线程池过载逃生的线程池使用率比例。该参数仅在GUC参数enable_thread_pool和use_workload_manager打开时生效。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，长度大于0 该参数分为recover_threadpool_percent、overload_threadpool_percent 2部分，这2个部分的具体含义如下： recover_threadpool_percent：线程池恢复正常状态时的线程池使用率，当线程池使用率小于该值时，停止过载逃生并放开新连接接入，取值为0~INT_MAX，设置为多少表示百分之多少。 overload_threadpool_percent：线程池过载时的线程池使用率，当线程池使用率大于该值时，表示当前线程池已经过载，触发过载逃生kill会话并禁止新连接接入，取值为0~INT_MAX，设置为多少表示百分之多少。 默认值：'0,0'，表示关闭线程池逃生功能。 示例： resilience_threadpool_reject_cond = '50,90' 表示线程池使用率超过90%后禁止新连接接入并kill堆积的会话，kill会话过程中线程池使用率下降到50%时停止kill会话并允许新连接接入。 线程池使用率可以通过DBE_PERF.local_threadpool_status视图查询获得；线程池设置的初试线程池线程数目可以通过查询thread_pool_attr参数获得。 该参数如果设置的百分比过小，则会频繁触发线程池过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际线程池使用情况慎重设置。 use_workload_manager参数关闭的情况下，如果打开bypass_workload_manager，则该参数也会生效，但是因为bypass_workload_manager是SIGHUP类型，reload方式设置后需要重启数据库才会使得当前功能生效。 recover_threadpool_percent和overload_threadpool_percent的值可以同时为0，除此之外，recover_threadpool_percent的值必须要小于overload_threadpool_percent，否则会设置不生效。

thread_pool_stream_attr 参数说明：用于控制stream线程池功能的详细属性，stream线程只在DN生效，该参数仅在enable_thread_pool打开后生效，仅sysadmin用户可以访问。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，长度大于0 该参数分为4个部分，'stream_thread_num, stream_proc_ratio ,group_num ,cpubind_info'，这4个部分的具体含义如下： stream_thread_num：stream线程池中的线程总数，取值范围是0~4096。其中0的含义是数据库根据系统CPU core的数量来自动配置线程池的线程数，如果参数值大于0，线程池中的线程数等于stream_thread_num。线程池大小推荐根据硬件配置设置，计算公式如下：stream_thread_num = CPU核数*3~5，stream_thread_num最大值为4096。 stream_proc_ratio：预留给stream线程的proc数量比例，浮点类型，默认为0.2，预留proc计算方式为：stream_proc_ratio * stream_thread_num。 group_num：线程池中的线程分组个数，取值范围是0~64。其中0的含义是数据库根据系统NUMA组的个数来自动配置线程池的线程分组个数，如果参数值大于0，线程池中的线程组个数等于group_num。thread_pool_stream_attr的group_num需与thread_pool_attr的group_num配置和使用保持一致，若设置为不同值，以thread_pool_attr的group_num为准。 cpubind_info：线程池是否绑核的配置参数。可选择的配置方式有几种：1. '(nobind)' ，线程不做绑核；2. '(allbind)'，利用当前系统所有能查询到的CPU core做线程绑核；3. '(nodebind: 1, 2)'，利用NUMA组1,2中的CPU core进行绑核；4. '(cpubind: 0-30)'，利用0-30号CPU core进行绑核；5. '(numabind: 0-30)'，在NUMA组内利用0-30号CPU core进行绑核。该参数不区分大小写。thread_pool_stream_attr的cpubind_info需与thread_pool_attr的cpubind_info配置和使用保持一致，若设置为不同值，以thread_pool_attr的cpubind_info为准。 默认值： stream_thread_num：16 stream_proc_ratio：0.2 group_num、cpubind_info：参见thread_pool_attr。

hll_default_log2sparse 参数说明：该参数可以用来设置从Sparse模式到Full模式的默认阈值大小。 参数类型：整型 参数单位：无 取值范围：0~14。0表示跳过Explicit模式，取1~14表示在基数到达2hll_default_log2sparse时切换模式。 默认值：12 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值，可以根据实际业务需要进行调整。

hll_default_log2explicit 参数说明：该参数可以用来设置从Explicit模式到Sparse模式的默认阈值大小。 参数类型：整型 参数单位：无 取值范围：0~12。0表示跳过Explicit模式，取1~12表示在基数到达2hll_default_log2explicit时切换模式。 默认值：10 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值，可以根据实际业务需要进行调整。

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

hll_default_expthresh（废弃） 参数说明：该参数可以用来设置从Explicit模式到Sparse模式的默认阈值大小。当前已经使用参数hll_default_log2explicit替代类似功能。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，-1~7。-1表示自动模式，0表示跳过Explicit模式，取1-7表示在基数到达2hll_default_expthresh时切换模式。 默认值：-1

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

enable_tde 参数说明：透明 数据加密 功能开关。创建加密表前需要将此参数置为on，并且通过tde_key_info参数配置密钥信息。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型。 on：开启透明数据加密功能。 off：关闭透明数据加密功能。 默认值：off 设置此参数为on，需要保证tde_key_info参数中密钥信息配置正确，并且密钥服务可以正常访问，否则会导致数据库无法正常启动。 设置此参数为on并且创建了加密表后，如果再将此参数设置为off会导致已有加密表的数据无法进行加解密，从而导致数据库异常。

enable_rls_match_index 参数说明：控制是否支持在行级访问控制特性使用场景中，基于目标谓词条件对基表执行索引扫描。目标场景为：基表设置并开启了RLS（Row Level Security）策略，查询谓词中包含unleakproof类型系统函数或like操作符。 取值范围：布尔型。 on：支持目标场景下的基表索引扫描。 off：不支持目标场景下的基表索引扫描。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：设置为默认值。若业务热点查询语句为目标场景，且基表行级访问策略数量较少，可打开该开关以显著提升查询性能。 该参数的修改，会影响目标场景下执行计划的生成，可通过重连、创建操作符等方式手动使缓存计划失效。 该参数开启后，会影响到位图扫描算子的生成，RLS策略谓词将被插入到Recheck过滤条件中；因此，在该算子切换为lossy模式且RLS策略数目较多时，会对性能产生一定影响。

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中对应设置方法进行设置。 取值范围：字符串。 默认值：''

tde_index_default_encrypt 参数说明：创建索引时，如果开启本参数，并且索引的基表是加密表，则数据库自动将索引设置为加密索引，并自动为索引复制基表的加密算法、密钥等加密参数，对索引中的数据先加密再存储。 参数类型：布尔型 参数单位：无 取值范围： on：自动对加密表的索引设置加密参数。 off：不自动对加密表的索引设置加密参数。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议设置为默认值。

wdr_snapshot_interval 参数说明：后台线程Snapshot自动对数据库监控数据执行各项快照操作的时间间隔。 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。 参数类型：整型 参数单位：分钟 取值范围：10～60 默认值：60 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值60，表示wdr_snapshot_interval为60min；带单位取值1h，表示wdr_snapshot_interval为1h。取值如果要带单位，必须为min、h、d。 设置建议：设置为默认值。在固定保留天数下，该参数取值越小，磁盘占用量越大。

enable_wdr_snapshot_standby 参数说明：是否开启WDR功能支持分布式备机，开启该参数WDR snapshot会获取备机的性能数据，并存储在主机。 参数类型：布尔型 参数单位：无 取值范围： on：开启WDR功能支持分布式备机。 off：关闭WDR功能支持分布式备机。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值。若要更改，请在理解参数含义后谨慎操作，避免因误操作产生意料之外的风险。

wdr_snapshot_space_threshold 参数说明：快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的50%时，会启用数据库的控制逻辑，使快照占用空间趋于平稳。 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。 若将该参数取值改得比当前快照占用空间要小，并不会使快照占用空间回缩，而是开启控制逻辑，控制快照增长，使快照占用空间趋于平稳。 参数类型：整型 参数单位：kB 取值范围：0～107374182400 默认值：0，表示不开启按空间阈值控制快照占用空间的功能。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据需求场景进行配置。

asp_sample_num 参数说明：LOCAL_ACTIVE_SESSION视图最大的样本个数，仅sysadmin用户可以访问。 参数类型：整型 参数单位：无 取值范围：10000～100000 默认值：100000 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值。若要更改，请在理解参数含义后谨慎操作，避免因误操作产生意料之外的风险。

wdr_snapshot_retention_days 参数说明：系统中数据库监控快照数据的保留天数。当数据库运行过程期间所生成的快照数量超过保留天数内允许生成的快照数量的最大值(默认为24*8=192)时，系统将每隔wdr_snapshot_interval时间间隔，清理一次snapshot_id最小的快照数据。 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。 参数类型：整型 参数单位：天 取值范围：1～30 默认值：8 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值。该参数取值越大，磁盘占用越高。

wdr_snapshot_full_backup_interval 参数说明：WDR snapshot做全量快照的间隔。该参数控制的不是时间间隔，而是间隔个数。例如，当取值为12时，每一组先生成一个全量快照，再生成11个增量快照；当取值为1时，每个快照都是全量快照。 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。 若在已经生成若干个快照的情况下，更改该参数取值，下一个快照会是全量快照。例如，WDR snapshot当前已经生成了5个增量快照，此时更改参数取值为10，那么下一个快照会为全量快照，然后开启新的周期。 在删除快照的时候，会遵循一组快照一起删除的规则。删除快照的数量受最早的一组快照产生时该参数的取值影响，与该参数的当前取值无关。 参数类型：整型 参数单位：个 取值范围：1～24 默认值：12 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据需求场景进行配置。该参数取值越小，全量快照越多，同样空间占用下能保留的总快照数量越少。

enable_show_standby_name 参数说明：在主备DN上设置该参数，查询性能视图，视图中的node_name可以区分主备机，开启该功能后在同一分片的不同节点上查询dbe_perf.node_name，返回不同的名字。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on：开启视图区分主备机名字功能。 off：关闭视图区分主备机名字功能。 默认值：off

track_stmt_flush_mode 参数说明：控制Full SQL的存储模式。 参数类型：字符型 参数单位：无 取值范围： 该参数分为两部分，形式为'full sql flush mode, slow sql flush mode'： 第一部分为全量SQL跟踪模式，取值可为MEMORY、FILE。参数设置为MEMORY，会记录全量SQL语句到内存中；参数设置为FILE，会记录全量SQL语句到磁盘文件中。 第二部分为慢SQL跟踪模式，当前版本取值仅为FILE。参数设置为FILE，会记录慢SQL语句到磁盘文件中。 默认值："FILE,FILE" 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：如果设置参数为"MEMORY,FILE"会打开内核支持全量SQL功能，会占用一定共享内存，内存大小由track_stmt_shm_size参数控制。

concurrent_dml_mode 参数说明：对于启用了更新分布列功能的表（即表属性“enable_update_distkey”为“on”），针对该表上出现的DML并发执行冲突（锁冲突），指定冲突的处理方式。 该参数仅在DataNode节点上生效。 参数类型：整型 参数单位：无 取值范围：0, 1 0：宽松模式，即出现冲突后，后获取锁的DML语句不报错。 1：严格模式，即出现冲突后，后获取锁的DML语句将会终止，并输出错误信息。 默认值：0 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：可参考取值范围描述进行设置。若预期冲突后，后获取锁DML语句不报错，则可设置为0；若预期冲突后，后获取锁的DML语句终止且报错，则可设置为1。

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_combination_options 参数说明：Unique SQL 同类语句归并功能配置项，该参数的值由若干个配置项用逗号隔开构成。 开启该特性会将同类语句的Unique SQL ID归一，并将生成的Unique SQL String做归一化处理。 参数类型：字符串 参数单位：无 取值范围：参照表1 归并功能配置时，按照表1设置字符串，多个配置项之间用逗号隔开，例如：set instr_unique_sql_combination_options='in_clause'; 参数设置为空时，即为不开启该功能，例如：set instr_unique_sql_combination_options=''; 表1 归并功能配置项 归并功能配置项 归并功能行为控制 in_clause 控制select in()语句的in中仅含有固定参数与预编译绑定参数的情况进行归并。 例1：select * from table where column in (1,2,3)； 归并后Unique SQL String：select * from table where column in (1…n); 例2：select * from table where column in ($1,$2,$3)； 归并后Unique SQL String：select * from table where column in ($1…$n); 例3：select * from example_table where column in (1,2,$1,3,$2); 归并后Unique SQL String：select * from example_table where column in (1...n,$1...$n); 例4：select * from example_table where (column1, column2) in ((1, 'a'), (2, 'b'), (3, 'c')); 归并后Unique SQL String：select * from example_table where (column1, column2) in ((1...n)); 默认值：'in_clause' 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：升级时默认关闭，新实例下发时默认开启。 使用该特性将使涉及归并的查询语句的Unique SQL ID发生改变，会对已创建SQLpatch的SQL语句产生影响。 对于bigint，real，float4，blob，numeric, decimal，number，dec，integer类型的值，在in()中含有单个参数与多个参数的两种情况，会生成两种不同的unique_sql_id。

query_log_directory（废弃） 参数说明：enable_slow_query_log设置为on时，query_log_directory决定存放服务器慢查询日志文件的目录，仅sysadmin用户可以访问。它可以是绝对路径，或者是相对路径（相对于数据目录的路径），在该版本中已废弃。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 当配置文件中query_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_session_slot 参数说明：设置一个session缓存的最大的全量SQL和慢SQL的数量，超过这个数量，新的语句执行将不会被跟踪，直到落盘线程将缓存语句落盘，留出空闲的空间。 参数类型：整型 参数单位：无 取值范围：0 ~ 2147483647 默认值：1000 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值，即每个session能够保留的全量SQL的最大槽位。该参数如果太大会占用较大内存，较小的话可能出现全量SQL丢失。

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

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