GUC参数

force_read_from_rw

参数说明：强制从其他逻辑集群上读取数据（从表所在逻辑集群上读取数据）。

参数类型：USERSET

取值范围：布尔型

默认值：off

是否用户可设：不建议

kv_sync_up_timeout

参数说明：KV同步等待超时时间。

参数类型：USERSET

取值范围：整型，0-2147483647

默认值： 10min

是否用户可设：可设定

enable_cudesc_streaming

参数说明：开启跨逻辑集群访问走cudesc streaming路径(从表所在逻辑集群拉取cudesc、delta表数据等信息)。

参数类型：SUPERUSER

默认值： on

是否用户可设：可设定

enable_cu_align_8k

参数说明：是否强制cu对齐到8k大小。

参数类型：USERSET

取值范围：布尔型

默认值： off

是否用户可设：可设定

enable_cu_batch_insert

参数说明：是否开启列存的批量插入。

参数类型：USERSET

取值范围：布尔型

默认值：on

是否用户可设：可设定

enable_disk_cache

参数说明：是否打开文件缓存。

参数类型：USERSET

取值范围：布尔型

默认值： on

是否用户可设：可设定

enable_disk_cache_recovery

参数说明：是否允许在重启集群时恢复文件缓存。

参数类型：USERSET

取值范围：布尔型

默认值： on

是否用户可设：不建议

disk_cache_block_size

参数说明：文件系统缓存单个 block 的大小（单位 KB）。

参数类型：postmaster

取值范围：整型，8KB~1TB

默认值： 1MB

是否用户可设：可设定

disk_cache_max_size

参数说明：文件系统缓存的总大小限制（单位 KB）。

参数类型：SIGHUP

取值范围：整型，1MB~1PB

默认值：5GB

是否用户可设：可设定

disk_cache_max_open_fd

参数说明：文件系统缓存同时打开的文件数量限制。

参数类型：postmaster

取值范围：整型，0-INT_MAX

默认值：1000

是否用户可设：可设定

dfs_max_memory

参数说明：外表读写使用内存的上限值(单位：KB)。

参数类型：USERSET

取值范围：整型，131072~10485760

默认值：256MB

是否用户可设：是

enable_aio_scheduler

参数说明：打开用户态IO管控框架，打开后，所有OBS IO请求被用户态IO管控框架接管，同时开启异步读/写。

参数类型：SIGHUP

取值范围：布尔型

默认值：on

是否用户可设：可设

obs_worker_pool_size

参数说明：参数大小代表在打开用户态IO管控框架时，代理执行OBS读/写操作线程的最大数目。

参数类型：postmaster

取值范围：整型，4~2048

默认值：128

是否用户可设：不建议

async_io_acc_max_memory

参数说明：查询在单个任务线程中异步读/写加速特性可使用的最大内存（单位：KB）

参数类型：USERSET

取值范围：整型，4096KB - INT_MAX/2 KB

默认值：128MB

是否用户可设：是

enable_metaversion

参数说明：是否开启DN全局元数据缓存。DN开启元数据后，会额外占用内存空间，内存空间由local_metacache_size和global_metacache_size控制。

参数类型：SUPERUSER

取值范围：布尔型

默认值：off

是否用户可设：不建议

local_metacache_size

参数说明：用于控制DN本地Session内元数据缓存大小。在极端场景下，若SQL所使用的元数据内存超过该值，SQL不会报错，在SQL执行结束后，会进行LRU淘汰，直至内存占用小于该值。

参数类型：SUPERUSER

取值范围：整型，1024 KB~INT_MAX KB

默认值：128MB

是否用户可设：不建议

global_metacache_size

参数说明：用于控制DN全局元数据缓存大小。

参数类型：SUPERUSER

取值范围：整型，1024 KB~INT_MAX KB

默认值：256MB

是否用户可设：不建议

enable_metadata_partprune

参数说明：用于控制是否开启元数据分区剪枝功能。当该参数开启后，DN将不缓存被剪枝的元数据。

参数类型：SUPERUSER

取值范围：布尔型

默认值：on

是否用户可设：不建议

fast_tablesize

参数说明：计算表大小时使用快速计算方式，有误差。

参数类型：USERSET

取值范围：布尔型

默认值：off

是否用户可设：是

analyze_sample_multiplier

参数说明：外表analyze采样的stripe采样率的扩大倍数，设为0的时候表示stripe采样率为100%。

参数类型：SUPERUSER

取值范围：整型，0~100

默认值：3

是否用户可设：不建议

enable_parallel_analyze

参数说明：针对内外表analyze采样时，是否使用并行的采样方式。

参数类型：USERSET

取值范围：布尔型

默认值：on

是否用户可设：是

enable_external_schema_use_dws_stats

参数说明：针对external schema表查询时，是否采用已经写出HiveMetaStore的统计信息。该参数仅9.0.3及以上版本支持。

参数类型：USERSET

取值范围：布尔型

默认值：off

是否用户可设：是

parallel_analyze_workers

参数说明：使用并行的analyze采样方式时，并发的线程数量。

参数类型：USERSET

取值范围：整型，0-64

默认值：10

是否用户可设：是

pgxc_node_readonly

参数说明：标记CN、DN实例是否为只读节点。

参数类型：SUPERUSER

取值范围：布尔型

默认值：off

是否用户可设：否

enable_foreign_meta_shipping

参数说明：是否开启外表元数据下发，如果开启该参数，读集群将能够执行外表读写。

参数类型：USERSET

取值范围：布尔型

默认值：on

是否用户可设：是

enable_batchsort_heapsort_opt

参数说明：是否启用堆排序优化，对"Order By...Limit..."查询有一定优化。

参数类型：USERSET

取值范围：布尔型

默认值：on

是否用户可设：不推荐

enable_batchsort_ips4o

参数说明：是否为Batchsortstate启用IPS4O排序算法。

参数类型：USERSET

取值范围：布尔型

默认值：off

是否用户可设：当前不推荐

enable_batchsort_new_sorting

参数说明：是否为Batchsortstate启用新的排序优化。

参数类型：USERSET

取值范围：布尔型

默认值：on

是否用户可设：不推荐

enable_batchsort_specializations

参数说明：是否为Batchsortstate启用新专业优化，如果enable_batchsort_new_sorting关闭，则此选项失效。

参数类型：USERSET

取值范围：布尔型

默认值：on

是否用户可设：不推荐

force_disable_text_abbrev

参数说明：是否强制关闭“缩略键”排序优化。

参数类型：USERSET

取值范围：布尔型

默认值：off

是否用户可设：不推荐

enable_insert_dop

参数说明：在导入数据时是否开启DOP，如果开启该参数，数据导入性能高，但是CPU和内存资源消耗会增多。

参数类型：USERSET

取值范围：布尔型

默认值：off

是否用户可设：可设定

enable_insert_ft_dop

参数说明：在导出数据到obs外表时是否开启DOP，如果开启该参数，导出数据性能高，但是CPU和内存资源消耗会增多。

参数类型：USERSET

取值范围：布尔型

默认值：off

是否用户可设：可设定

enable_insert_ft_dop_performance

参数说明：该参数是在enable_insert_ft_dop开启时生效。在导出数据到OBS分区外表时是否开启性能模式，如果开启该参数，导出数据性能高，但是内存资源消耗会明显增多。如果用户能评估分区外表的分区数目极少且内存资源非常充足时，可以开启，否则建议关闭。

参数类型：USERSET

取值范围：布尔型

默认值：off

是否用户可设：可设定

parquet_timestamp_skip_conversion

参数说明：该参数控制当外表读取parquet格式文件数据时，如读取到int96格式的时间戳类型时是否进行本地时区转换。

• 设置为off时：

  在parquet文件中的读取到int96格式的时间戳类型数据时，对数据进行从UTC时区到本地时区转换的操作。

• 设置为on时：

  在parquet文件中的读取到int96格式的时间戳类型数据时，跳过对数据从UTC时区到本地时区转换的操作。

参数类型：USERSET

取值范围：布尔型

默认值：off

是否用户可设：可设定

parquet_enable_integer_decimal

参数说明：为parquet外表添加guc控制参数parquet_enable_integer_decimal，用于控制写入数据时逻辑类型decimal/numeric类型的转换规则。在decimal/numeric类型定义中，如果指定了precision的范围值，参数语义如下：

• 设置为off时：
  • 1 ≤ precision ＜ 39时，写入到定长数组FIXED_LEN_BYTE_ARRAY类型中，该格式与 Apache Hive 和 Apache Impala中的decimal一致。
  • precision ≥ 39时，写入变长数组BYTE_ARRAY类型中。

• 设置为on时：
  • 1 ≤ precision ＜ 19时，写入到Int64类型中。
  • 19 ≤ precision ＜ 39时，写入到定长数组FIXED_LEN_BYTE_ARRAY类型中。
  • precision ≥ 39时，写入变长数组BYTE_ARRAY类型中。

参数类型：USERSET

取值范围：布尔型

默认值：on

是否用户可设：是

enable_stream_ctescan

参数说明：控制stream计划是否支持ctescan。9.0.3版本默认关闭。

参数类型：USERSET

取值范围：布尔型

• on表示stream计划下支持ctescan。
• off表示stream计划下不支持ctescan。

默认值：off

dfs_encoding_compatibility

参数说明：仅9.0.3及以上版本支持。OBS上的orc和parquet的分区外表数据导出时，分区键值作为分区目录时的特殊字符的编码方式，可选参数为default和hive。

• 设置为default时，分区目录中的特殊字符按默认方式编码。
• 设置为hive时，分区目录中的特殊字符编码方式对齐FusionInsight的Hive 3.1.0版本。

参数类型：USERSET

取值范围：字符串

默认值：dafault

是否用户可设：不建议

install_as_standby

参数说明：表示启动时此节点是否为备节点。

参数类型：POSTMASTER

取值范围：布尔型

on表示设置此节点为备节点

off表示设置此节点为主节点

默认值：off

是否用户可设：不建议

enable_codegen

参数说明：标识是否允许开启代码生成优化，目前代码生成使用的是LLVM优化。9.0.3及以上版本默认关闭。

参数类型：USERSET

取值范围：布尔型

• on表示允许开启代码生成优化。
• off表示不允许开启代码生成优化

foreign_table_default_rw_options

参数说明：仅9.0.3及以上版本支持。用于控制创建外表时未指定权限时的默认权限，其选项分别为READ_ONLY，WRITE_ONLY，READ_WRITE

参数类型：USERSET

取值范围：字符串

默认值：READ_ONLY

是否用户可设：是