# 其它选项
#### server_version
**参数说明：**报告服务器版本号（字符串形式）。
**参数类型：**SIGHUP
**取值范围：**字符串
**默认值：**9.2.4
#### server_version_num
**参数说明：**报告服务器版本号（整数形式）。
**参数类型：**SIGHUP
**取值范围：**整数，90204\~2147483647
**默认值：**90204
#### sql_dialect
**参数说明：**为当前数据库绑定方言插件。该参数仅9.1.1.100及以上集群版本支持。
**参数类型：**USERSET
**取值范围：**mysql
**默认值：空**
![](https://support.huaweicloud.com/devg-911-dws/public_sys-resources/note_3.0-zh-cn.png)
需先安装sql_dialect插件，使用ALTER DATABASE *database_nam* *e* SET sql_dialect = 'mysql'; 语句设置该参数。
#### dfs_partition_directory_length
**参数说明：**在HDFS文件系统上，构造HDFS VALUE分区表的分区目录时，目录名长度的上限值。
**参数类型：**USERSET
**取值范围：**92～7999
**默认值：**512
#### enable_hadoop_env
**参数说明：**设置使用Hadoop特性时，是否允许在数据库中创建本地行存表和列存表。DWS集群中，集群安装好后，该参数默认设为off。以支持本地行列存储和跨集群访问Hadoop特性。不推荐用户调整enable_hadoop_env的值。
**参数类型：**USERSET
**取值范围：** 布尔型
- on/true，表示使用Hadoop特性时，不允许在数据库中创建本地行存表和列存表。
- off/false，表示使用Hadoop特性时，可以在数据库中创建本地行存表和列存表。
**默认值：**off
#### enable_upgrade_merge_lock_mode
**参数说明：**当该参数设置为on时，通过提升deltamerge内部实现的锁级别，避免和update/delete并发操作时的报错。
**参数类型：**USERSET
**取值范围：** 布尔型
- on，提升deltamerge内部实现的锁级别，并发执行deltamerge和update/delete操作时，一个操作先执行，另一个操作被阻塞，在前一个操作完成后，后一个操作再执行。
- off，在对HDFS表的delta table的同一行并发执行deltamerge和update/delete操作时，后一个对同一行数据更新的操作会报错退出。
**默认值：**off
#### job_queue_processes
**参数说明：**表示系统可以并发执行的job数目。
**参数类型：**POSTMASTER
**取值范围：**0～1000
功能：
- 当job_queue_processes设置为0值，表示不启用定时任务功能，任何job都不会被执行（因为开启定时任务的功能会对系统的性能有影响，有些局点可能不需要定时任务的功能，可以通过设置为0不启用定时任务功能）。
- 当job_queue_processes为大于0时，表示启用定时任务功能且系统能够并发处理的最大任务数。
启用定时任务功能后，job_scheduler线程会在定时时间间隔轮询pg_jobs系统表，系统设置定时任务检查周期默认为1s。
由于并行运行的任务数太多会消耗更多的系统资源，因此需要设置系统并发处理的任务数，当前并发的任务数达到job_queue_processes时，且此时又有任务到期，那么这些任务本次得不到执行而延期到下一轮询周期。因此，建议用户需要根据每个任务的执行时长合理地设置任务的时间间隔（即submit接口中的interval参数），来避免由于任务执行时间太长而导致下个轮询周期无法正常执行。
注：如果同一时间内并行的job数很多，过小的参数值会导致job等待。而过大的参数值则消耗更多的系统资源，建议设置此参数为100，用户可以根据系统资源情况合理调整。
**默认值：**10
#### ngram_gram_size
**参数说明：**ngram解析器分词的长度。
**参数类型：**USERSET
**取值范围：**整型 ，1～4
**默认值：**2
#### ngram_grapsymbol_ignore
**参数说明：**ngram解析器是否忽略图形化字符。
**参数类型：**USERSET
**取值范围：**布尔型
- on表示忽略图形化字符。
- off表示不忽略图形化字符。
**默认值：**off
#### ngram_punctuation_ignore
**参数说明：**ngram解析器是否忽略标点符号。
**参数类型：**USERSET
**取值范围：**布尔型
- on表示忽略标点符号。
- off表示不忽略标点符号。
**默认值：**on
#### zhparser_multi_duality
**参数说明：**Zhparser解析器设定是否将长词内的文字自动以二字分词法聚合。
**参数类型：**USERSET
**取值范围：**布尔型
- on表示将长词内的文字自动以二字分词法聚合。
- off表示不将长词内的文字自动以二字分词法聚合。
**默认值：**off
#### zhparser_multi_short
**参数说明：**Zhparser解析器分词执行时是否执行针对长词复合切分。
**参数类型：**USERSET
**取值范围：**布尔型
- on表示执行针对长词复合切分。
- off表示不执行针对长词复合切分。
**默认值：**on
#### zhparser_multi_zall
**参数说明：**Zhparser解析器是否将全部单字单独显示。
**参数类型：**USERSET
**取值范围：**布尔型
- on表示将全部单字单独显示。
- off表示不将全部单字单独显示。
**默认值：**off
#### zhparser_multi_zmain
**参数说明：**Zhparser解析器是否将重要单字单独显示。
**参数类型：**USERSET
**取值范围：**布尔型
- on表示将重要单字单独显示。
- off表示不将重要单字单独显示。
**默认值：**off
#### zhparser_punctuation_ignore
**参数说明：**Zhparser解析器分词结果是否忽略所有的标点等特殊符号（不会忽略\\r和\\n）。
**参数类型：**USERSET
**取值范围：**布尔型
- on：忽略所有的标点等特殊符号。
- off：不忽略所有的标点等特殊符号。
**默认值：**on
#### zhparser_seg_with_duality
**参数说明：**Zhparser解析器是否将闲散文字自动以二字分词法聚合。
**参数类型：**USERSET
**取值范围：**布尔型
- on表示将闲散文字自动以二字分词法聚合。
- off表示不将闲散文字自动以二字分词法聚合。
**默认值：**off
 #### acceleration_with_compute_pool
**参数说明：**在查询包含OBS时，通过该参数决定查询是否通过计算资源池进行加速。
**参数类型：**USERSET
**取值范围：**布尔型
- on表示包含有OBS的查询在计算资源池可用时，会根据代价评估决定是否通过计算资源池对查询加速。
- off表示任何查询都不会通过计算资源池进行加速。
**默认值：**off
#### redact_compat_options
**参数说明：**设置数据脱敏可算不可见兼容性行为配置项。该参数仅8.1.3.310及以上集群版本支持。
**参数类型：**USERSET
**取值范围：**枚举类型
- none，表示未配置兼容项。
- disable_comparison_operator_mask，表示允许不存在暴露原始数据风险的比较操作符绕过脱敏检查，输出实际计算结果。
- relaxed_redact_check，表示对数据脱敏列类型校验进行弱管控，支持修改依赖脱敏的表字段列类型。该配置项仅9.1.0.222及以上的9.1.0.xxx集群版本支持；9.1.1.200及以上集群版本支持。
**默认值：**none
#### table_skewness_warning_threshold
**参数说明**：设置用于表倾斜告警的阈值。
**参数类型：**USERSET
**取值范围**：浮点型，0～1
**默认值**：1
#### table_skewness_warning_rows
**参数说明**：设置用于表倾斜告警的行数。
**参数类型：**USERSET
**取值范围**：整型，0～INT_MAX
**默认值**：100000
#### enable_view_update
**参数说明**：用于设置是否开启视图更新功能。
**参数类型：**POSTMASTER
**取值范围：**布尔型
- on表示启用视图更新功能。
- off表示关闭视图更新功能。
**默认值：**on
![](https://support.huaweicloud.com/devg-911-dws/public_sys-resources/notice_3.0-zh-cn.png)
新安装9.1.1.100及以上集群版本中该参数的默认值为on，升级场景下该参数的默认值为保持前向兼容维持原值。
#### view_independent
**参数说明**：用于设置是否开启视图与表、函数、同义词的解耦功能。基表恢复后目前已支持自动关联重建。
**参数类型：**SIGHUP
**取值范围：**布尔型
- on表示启用视图解耦功能，存在视图依赖的表、函数、同义词及其他视图可以单独删除（临时表及临时视图除外），关联视图保留但不可用。
- off表示关闭视图解耦功能，存在视图依赖的表、函数、同义词及其他视图不可以单独删除，仅可使用cascade级联删除。
**默认值：**off
#### assign_abort_xid
**参数说明：**查询时将指定的xid判断为需要abort的事务。
**参数类型：**USERSET
**取值范围：**指定xid的字符串
![](https://support.huaweicloud.com/devg-911-dws/public_sys-resources/caution_3.0-zh-cn.png)
此参数只用于用户误删数据(delete操作)后进行快速恢复。其他场景禁止使用，否则造成事务可见性错误问题。
#### default_distribution_mode
**参数说明** **：**用于设置表的默认分布方式。该参数仅8.1.2及以上版本支持。
**参数类型：**USERSET
**取值范围：** 枚举类型
- roundrobin，创建表不指定分布方式时，按如下规则选取默认分布方式：
  1. 若建表时包含主键/唯一约束，则选取HASH分布，分布列为主键/唯一约束对应的列。
  
  2. 若建表时不包含主键/唯一约束，则选取ROUNDROBIN分布。
   
- hash，创建表不指定分布方式时，按如下规则选取默认分布方式：
  1. 若建表时包含主键/唯一约束，则选取HASH分布，分布列为主键/唯一约束对应的列。
  
  2. 若建表时不包含主键/唯一约束，但存在数据类型支持作分布列的列，则选取HASH分布，分布列为第一个数据类型支持作分布列的列。
  
  3. 若建表时不包含主键/唯一约束，也不存在数据类型支持作分布列的列，选取ROUNDROBIN分布。
   
 
**默认值：**roundrobin
![](https://support.huaweicloud.com/devg-911-dws/public_sys-resources/note_3.0-zh-cn.png)
新建8.1.2集群版本默认值为roundrobin，升级到8.1.2集群版本场景该参数的默认值为hash。
#### object_mtime_record_mode
**参数说明：**用于设置PG_OBJECT系统表中mtime字段的更新行为。
**参数类型：**SIGHUP
**取值范围：**字符串
- default，表示默认行为包括ALTER、COMMENT、GRANT/REVOKE和TRUNCATE操作会更新mtime字段。
- disable，表示不更新mtime字段。
- disable_acl，表示GRANT/REVOKE操作不更新mtime字段。
- disable_truncate，表示TRUNCATE操作不更新mtime字段。
- disable_partition，表示分区表相关ALTER操作不更新mtime字段。
**默认值：**default
#### max_volatile_tables
**参数说明**：指定每个session创建的volatile临时表最大个数，其中包括volatile临时表自身及其附属表。该参数仅8.2.0及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：整型，0\~INT_MAX
**默认值**：300
#### query_cache_refresh_time
**参数说明**：用于控制enable_accelerate_select生效的查询的缓存刷新时间。该参数仅8.3.0及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：浮点型，0\~10000.0，单位为秒（s）。
**默认值**：60.0
#### default_cache_distribution_mode
**参数说明**：用于控制自动创建物化视图的分布方式。该参数仅9.1.0.100及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：枚举类型
- roundrobin：表的每一行被轮番地发送给各个DN，因此数据会被均匀地分布在各个DN中。

- replication：表的每一行存储在所有DN中，即每个数据节点都有完整的表数据。
**默认值**：roundrobin
#### vector_engine_strategy
**参数说明**：用于控制向量化增强策略。该参数仅8.3.0及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：枚举类型
- force表示向量化增强策略设置为存在不支持向量化场景时，强制回退为行存计划。
- improve表示向量化增强策略设置为存在不支持向量化场景时，启用向量化增强，尽可能将计划向量化。
**默认值**：improve
#### default_temptable_type
**参数说明**：用于控制CREATE TABLE创建临时表时在TEMP或TEMPORARY前未指定表类型所创建临时表的类型。该参数仅9.1.0及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：枚举类型
- local：表示在未指定类型的情况下创建local型临时表。
- volatile：表示在未指定类型的情况下创建volatile型临时表。
**默认值**：local
#### hudi_sync_max_commits
**参数说明**：设置Hudi同步任务单次同步的最大commits的数量。该参数仅9.1.0.100及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：整型，-1\~INT_MAX，其中-1和0表示不限制commits的数量。
**默认值**：-1
#### foreign_table_default_rw_options
**参数说明**：控制创建外表时未指定权限时的默认权限。仅9.0.3及以上版本支持。
**参数类型：**USERSET
**取值范围**：字符串
- READ_ONLY，表示只读权限。
- WRITE_ONLY，表示只写权限。
- READ_WRITE，表示读写权限。
**默认值**：READ_ONLY
#### analyze_options
**参数说明**：用于控制ANALYZE命令相关特性和功能。该参数仅9.1.1.100及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：枚举类型
- none：表示不启用任何ANALYZE的特性和功能选项。
- analyze_on_vw ：表示ANALYZE支持在弹性VW上执行。
- runtime_v3_table：表示对列存3.0表支持查询触发的Runtime Analyze。
- force_sample_new_data，表示ANALYZE支持从hstore opt的delta表中采样最新数据。该取值仅9.1.1.210及以上集群版本支持。
**默认值**：analyze_on_vw, force_sample_new_data
#### allow_system_table_vacuum_full
**参数说明**：设置是否允许VACUUM FULL系统表。该参数仅9.1.0.226及以上集群版本支持。
**参数类型：**SUSET
**取值范围**：布尔型
- on表示允许VACUUM FULL系统表。
- off表示不允许VACUUM FULL系统表。设置为off时，对指定系统表执行VACUUM FULL时会报错退出。若不指定表对整个数据库执行VACUUM FULL时，会自动跳过所有的系统表。
**默认值**：off
![](https://support.huaweicloud.com/devg-911-dws/public_sys-resources/warning_3.0-zh-cn.png)
VACUUM FULL系统表只能离线操作，在线VACUUM FULL系统表除了会锁表，还可能导致一些异常情况并产生报错。
#### enable_recycle_default_obs_tbs
**参数说明**：控制是否对default_obs_tbs（冷热表专用OBS表空间）进行残留文件扫描和清理。
DWS冷热表在使用中，可能由于系统故障导致冷热表专用OBS表空间default_obs_tbs生成无法自动清除的残留文件。随着这些文件的不断积累，它们会占用大量磁盘空间，导致磁盘使用率显示不准确，进而影响数据库的正常运维和运行。
开启此功能开关，可以自动清理default_obs_tbs中的残留文件。
该参数仅9.1.1.100及以上集群版本支持。
**参数类型：**SUSET
**取值范围**：布尔型
- on表示允许扫描和清理default_obs_tbs。
- off表示不允许扫描和清理default_obs_tbs。
**默认值**：off
 #### enable_pg_db_file
**参数说明** ：控制V3表写CU文件时文件信息是否记录到[PG_DB_FILE](https://support.huaweicloud.com/devg-911-dws/dws_04_1435.html)系统表，以及V3表的列存vacuum，表大小计算和空间管控等功能中获取文件信息的方式统一改为从PG_DB_FILE系统表遍历获取。该参数仅9.1.1.100及以上集群版本支持。
**参数类型：**USERSET
**取值范围**：布尔型
- on表示允许V3表写CU文件时文件信息记录到PG_DB_FILE系统表，同时V3表的列存vacuum，表大小计算和空间管控等功能中获取文件信息的方式统一改为从PG_DB_FILE系统表遍历获取。
- off表示不允许V3表写CU文件时文件信息记录到PG_DB_FILE系统表，同时V3表的列存vacuum，表大小计算和空间管控等功能中获取文件信息的方式不变。
**默认值**：on
![](https://support.huaweicloud.com/devg-911-dws/public_sys-resources/note_3.0-zh-cn.png)
- 9.1.1.100及以上新装集群默认为on，低版本集群升级到9.1.1.100及以上集群默认为off。
- 不建议已经打开enable_pg_db_file参数的集群再关闭该参数，否则会导致后续再打开时PG_DB_FILE系统表里的文件信息不准确。
- 若升级后的集群打开enable_pg_db_file，会通过autovacuum在PG_DB_FILE系统表上重建升级前表上的文件信息，因此需要保证列存autovacuum开启（即autovacuum_max_workers_col \> 0，colvacuum_threshold_scale_factor \> 0），只有重建完成后，对该表的vacuum才可以避免obs list操作。
 
#### installation_group_alias
**参数说明**：用于指定installation nodegroup的别名，在物理集群扩容后，确保CREATE TABLE...to group命令能够正确地指向当前的node group。该参数9.1.1.100及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：字符串
**默认值**：空
![](https://support.huaweicloud.com/devg-911-dws/public_sys-resources/note_3.0-zh-cn.png)
该参数支持设置为'all'， 表示CREATE TABLE...to group指定的nodegroup不存在时，默认创建到installation group。
#### enable_external_column_index_access
**参数说明**：控制external schema外表字段与实际文件字段的匹配方式。仅支持ORC和PARQUET格式。该参数仅9.1.1.200及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：布尔型
- on表示外表字段与文件字段按顺序匹配。
- off表示外表字段与文件字段按名字匹配，无法匹配的字段使用null填充。
**默认值**：on
#### max_partition_per_table
**参数说明**：设置创建分区表的最大分区数。该参数仅9.1.1.200及以上集群版本支持。
**参数类型**：SIGHUP
**取值范围**：整型，1\~32767
**默认值**：4096
#### cache_partition_options
**参数说明**：设置数据批量写入分区表时，系统是否会缓存最近一次分区结果。该参数仅9.1.1.200及以上集群版本支持。
**参数类型**：SIGHUP
**取值范围**：枚举类型
- range，表示该功能支持range分区类型的表。
- list，表示该功能支持list分区类型的表。
- none，表示关闭该功能。
**默认值**：range,list
#### enable_obs_limiter
**参数说明**：设置是否开启OBS异步IO限流，开启后限流配置生效。该参数仅9.1.1.200及以上集群版本支持。
**参数类型**：SIGHUP
**取值范围**：布尔类型
- on表示开启限流，当存在限流配置时，匹配对应的限流配置进行限流。
- off表示关闭限流，即使存在限流配置，也不进行限流。
**默认值**：on
#### hnsw_options
**参数说明**：设置pgvector hnsw索引相关查询选项。该参数仅9.1.1.200及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：字符串
- ef_search，表示控制查询参数（查询候选数），取值范围为1\~1000。
- max_scan_tuples，表示最大扫描节点数，取值范围为1\~INT_MAX。
- mem_scan_multiplier，表示内存动态扩张率，取值范围为1\~1000。
**默认值**：40,20000,1
![](https://support.huaweicloud.com/devg-911-dws/public_sys-resources/caution_3.0-zh-cn.png)
设置该参数时字符串内包含三个参数值，以逗号作为分隔。不支持单个参数独立设置。
#### ivfflat_options
**参数说明**：设置pgvector ivfflat索引相关查询选项。该参数仅9.1.1.200及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：字符串
- probes，表示扫描簇数，取值范围为1\~32768。
- max_probes，表示最大扫描簇数，取值范围为1\~32768。
**默认值**：1,32768
![](https://support.huaweicloud.com/devg-911-dws/public_sys-resources/caution_3.0-zh-cn.png)
设置该参数时字符串内包含两个参数值，以逗号作为分隔。不支持单个参数独立设置。
#### ivfflat_iterative_scan
**参数说明**：设置pgvector ivfflat索引迭代扫描模式，开启会自动扫描更多索引来获取足够的数据量。该参数仅9.1.1.200及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：枚举型
- relaxed_order，表示开启，但结果不按实际向量距离排序。
- off，表示不开启。
**默认值**：off
#### hnsw_iterative_scan
**参数说明**：设置pgvector hnsw索引迭代扫描模式，开启会自动扫描更多索引来获取足够的数据量。该参数仅9.1.1.200及以上集群版本支持。
**参数类型**：USERSET
**取值范围**：枚举型
- relaxed_order， 表示开启，但结果不按实际向量距离排序。
- strict_order，表示开启，且结果严格按照实际向量距离排序。
- off，表示不开启。
**默认值**：off