华为云用户手册

STATS_HISTORY_RETENTION_TIME 参数说明：每个对象（包括表、列、分区、索引）的历史统计信息保留时间。每个对象在收集统计信息时会同时存入历史统计信息表中，当历史统计信息表中该对象的统计信息的保留时间超过该阈值后，再次收集新的统计信息时，已经超过保留时间的统计信息会被清理。 参数类型：浮点型 参数单位：天 取值范围：-1、0 ~ 365000，-1表示历史统计信息不因时间而清除。 默认值：31 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值，如果需要记录更早时间的历史版本的统计信息可以适当调大该参数，但可能会对analyze的性能产生一定影响。

enable_extrapolation_stats 参数说明：标识对于日期类型是否允许基于历史统计信息使用推理估算的逻辑。使用该逻辑对于未及时收集统计信息的表可以增大估算准确的可能性，但也存在错误推理导致估算过大的可能性，需要对于日期类型数据定期插入的场景开启此开关。该参数属于SUSET类型参数，请参见表1中对应设置方法进行设置。 取值范围：布尔型 on表示允许基于历史统计信息使用推理估算的逻辑。 off表示不允许基于历史统计信息使用推理估算的逻辑。 默认值：off

immediate_analyze_threshold 参数说明：插入数据后自动做analyze的阈值。当一次新增数据量达到原有数据量的immediate_analyze_threshold倍，且总行数超过一百时，会自动触发一次analyze。 参数类型：整型 参数单位：无 取值范围：0~1000。当取值为零时，该功能关闭。 默认值：0 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：对数据变化较快且需要不断更新统计信息的表设置为较小值，对达到一定量数据后统计信息才产生较大波动的表设置为较大值。 该功能只支持永久表和非日志表，不支持临时表。 同一表不会在10s内两次被自动触发analyze。

enable_invisible_indexes 参数说明：设置优化器是否可以使用不可见索引。 索引在被设置为不可见状态后，可能会对查询语句的性能产生影响。此时若不想变更索引可见性状态，且打算使用不可见索引，可设置enable_invisible_indexes参数为on。 参数类型：布尔型 参数单位：无 取值范围： on：优化器可以使用不可见索引。 off：优化器不可以使用不可见索引。 默认值：off 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。

auto_explain_log_min_duration 参数说明：控制自动打印执行计划的耗时阈值，整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。比如设置为0，所有执行过的执行计划都会输出；设置为3000，单次语句执行耗时超过3000毫秒的所有执行的执行计划会输出。 参数类型：整型 参数单位：毫秒 取值范围：0~2147483647 默认值：0 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。

autoanalyze 参数说明：标识是否允许在生成计划的时候，对于没有统计信息的表进行统计信息自动收集。对于外表和临时表，不支持autoanalyze，如果需要收集统计信息，用户需手动执行analyze操作。如果在auto analyze某个表的过程中数据库发生异常，当数据库正常运行之后再执行语句有可能仍提示需要收集此表的统计信息。此时需要用户对该表手动执行一次analyze操作，以同步统计信息数据。 参数类型：布尔型 参数单位：无 取值范围： on表示允许自动进行统计信息收集。 off表示不允许自动进行统计信息收集。 默认值：off 设置方式：该参数属于SUSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 该参数与autovacuum线程下的autoanalyze无关。集中式下该参数不生效。

enable_analyze_check 参数说明：标识是否允许在生成计划的时候，对于在pg_class中显示reltuples和relpages均为0的表，检查这些表是否曾进行过统计信息收集。 参数类型：布尔型 参数单位：无 取值范围： on表示允许检查。 off表示不允许检查。 默认值：off 设置方式：该参数属于SUSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。

enable_sonic_optspill 参数说明：标识是否对面向列的hash表设计的Hash Join算子进行下盘文件数优化。该参数打开时，在Hash Join算子下盘文件较多的时候，下盘文件数不会显著增加。 该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 取值范围：布尔型 on表示优化面向列的hash表设计的Hash Join算子的下盘文件数。 off表示不优化面向列的hash表设计的Hash Join算子的下盘文件数。 默认值：on

enable_auto_explain 参数说明：控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询，对当前连接的数据库主节点和直连的备机有效。 参数类型：布尔型 参数单位：无 取值范围： true表示开启。 false表示关闭。 默认值：false 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值，若需查看执行计划，则开启，但会降低当前系统性能。

plan_cache_mode 参数说明：标识在prepare语句中，选择生成执行计划的策略。 参数类型：枚举型 参数单位：无 取值范围： auto表示按照默认的方式选择custom plan或者generic plan。 force_generic_plan表示强制走generic plan（软解析）。generic plan是指对于prepare语句生成计划，该计划策略会在执行execute语句的时候把参数bind到plan中，然后执行计划。这种方案的优点是每次执行可以省去重复的优化器开销；缺点是当bind参数字段上数据存在倾斜时该计划可能不是最优的，部分bind参数场景下执行性能较差。bind会绑定第一次传入的参数类型，如果同一占位符两次传入的参数类型不一致会导致报错。 force_custom_plan表示强制走custom plan（硬解析）。custom plan是指对于prepare语句，在执行execute的时候，把execute语句中的参数嵌套到语句之后生成的计划。custom plan会根据execute语句中具体的参数生成计划，这种方案的优点是每次都按照具体的参数生成优选计划，执行性能比较好；缺点是每次执行前都需要重新生成计划，存在大量的重复的优化器开销。 此参数只对prepare语句生效，一般用在prepare语句中参数化字段存在比较严重的数据倾斜的场景下。 默认值：auto 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：根据实际业务场景进行设置。

constraint_exclusion 参数说明：控制查询优化器使用表约束查询的优化。 该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 取值范围：枚举类型 on表示检查所有表的约束。 off表示不检查约束。 partition表示只检查继承的子表和UNION ALL子查询。 当constraint_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。 默认值：partition 目前， constraint_exclusion缺省被打开，通常用来实现表分区。为所有的表打开它时，对于简单的查询强加了额外的规划，并且对简单查询没有什么好处。如果不用分区表，可以关掉它。

cursor_tuple_fraction 参数说明：优化器估计游标获取行数在总行数中的占比。 该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 取值范围：浮点型，0.0～1.0。 比默认值小的值与使用 “fast start” 为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。 默认值：0.1

plan_mode_seed 参数说明：该参数为调测参数，目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中：OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan，参数值设置为0；RANDOM_PLAN表示随机生成的plan；如果设置为-1，表示用户不指定随机数的种子标识符seed值，由优化器随机生成[1, 2147483647]范围整型值的随机数，并根据随机数生成随机的执行计划；如果用户指定GUC参数值为[1, 2147483647]范围的整型值，表示指定的生成随机数的种子标识符seed，优化器需要根据seed值生成随机的执行计划。 该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 取值范围：整型，-1~ 2147483647。 默认值：0 当该参数设置为随机执行计划模式时，优化器会生成不同的随机执行计划，该执行计划可能不是最优计划。因此在随机计划模式下，会对查询性能产生影响，所以建议在升级、扩容、缩容等正常业务操作或运维过程中将该参数保持为默认值0。 当该参数不为0时，查询指定的plan hint不会生效。

join_collapse_limit 参数说明：根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 取值范围：整型，1～INT_MAX。 设置为1会避免任何JOIN重排。这样就使得查询中指定的连接顺序就是实际的连接顺序。查询优化器并不是总能选取最优的连接顺序，高级用户可以选择暂时把这个变量设置为1，然后指定它们需要的连接顺序。 比默认值小的数值减少规划时间但也降低了执行计划的质量。 默认值：8

codegen_cost_threshold 参数说明：由于LLVM编译生成最终的可执行机器码需要一定时间，因此只有当实际执行的代价大于编译生成机器码所需要的代码和优化后的执行代价之和时，利用代码生成才有收益。codegen_cost_threshold标识代价的阈值，当执行估算代价大于该代价时，使用LLVM优化。codegen使用执行算子的plan_rows作为代价与codegen_cost_threshold进行比较，plan_rows的值可以通过explain命令查看。 该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 取值范围：整型，0 ~ 2147483647。 默认值：100000

enable_plsql_opfusion 参数说明：如果开启该参数，可以对存储过程中的简单增删改查语句进行优化，提升SQL执行性能。 简单增删改查语句的限制请参见enable_opfusion中相关说明。 仅在enable_opfusion参数打开的状态下生效。 参数类型：布尔型 参数单位：无 取值范围： on表示使用。 off表示不使用。 默认值：on 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：设置为默认值，不做调整。

llvm_max_memory 参数说明：此参数设置Codegen编译产生的IR（包括缓存的和正在使用的）所占用的最大内存。Codegen使用的内存不使用预占的方式申请，属于max_dynamic_memory的一部分，且受llvm_max_memory参数的限制。 参数类型：整型 参数单位：kB 取值范围：0 ~ 2147483647，超过设定值则不再使用Codegen执行逻辑，降级为原有递归执行逻辑。当到达该上限触发执行降级后，调小llvm_max_memory的值无法立即释放多余IR所占用的内存，实际IR所占用的内存随着对应的SQL执行完毕后释放。 默认值：131072kB（128MB） 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：建议设置为默认值。 最大占用内存如果设置过小，则易使系统不再使用Codegen执行逻辑，影响功能使用。 最大占用内存如果设置过大，可能会造成LLVM的编译过多占用其他线程的资源，造成系统整体性能下降。

enable_global_plancache 参数说明：设置是否对PBE查询和存储过程中语句的执行计划进行缓存共享，开启该功能可以节省高并发下数据库节点的内存使用。 在打开enable_global_plancache的情况下，为保证GPC生效，默认local_syscache_threshold不小于16MB。即如当前local_syscache_threshold小于16MB，则设置为16MB，如大于16MB，则不改变。 参数类型：布尔型 参数单位：无 取值范围： on：表示对PBE查询和存储过程中语句的执行计划进行缓存共享。 off：表示不共享。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。

enable_opfusion 参数说明：控制是否对简单增删改查进行优化。 该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 简单查询限制如下： 只支持indexscan和indexonlyscan，且全部WHERE语句的过滤条件都在索引上。 只支持单表增删改查，不支持join、using。 只支持行存表，不支持分区表，表不支持有触发器。 不支持active sql、QPS等信息统计特性。 不支持正在扩容和缩容的表。 不支持查询或者修改系统列。 只支持简单SELECT语句，例如： SELECT c3 FROM t1 WHERE c1 = ? and c2 =10; 仅可以查询目标表的列，c1和c2列为索引列，后边可以是常量或者参数，可以使用 for update。 只支持简单INSERT语句，例如： INSERT INTO t1 VALUES (?,10,?); 仅支持一个VALUES，VALUES里面的类型可以是常量和参数，不支持returning。 只支持简单DELETE语句，例如： DELETE FROM t1 WHERE c1 = ? and c2 = 10; c1和c2列为索引列，后边可以是常量或者参数。 只支持简单UPDATE语句，例如： UPDATE t1 SET c3 = c3+? WHERE c1 = ? and c2 = 10; c3列修改的值可以是常量和参数，也可以是一个简单的表达式，c1和c2列为索引列，后边可以是常量或者参数。 取值范围：布尔型 on表示使用。 off表示不使用。 默认值：on

查询规划 介绍查询优化器方法配置、开销常量、规划算法以及一些配置参数。 优化器中涉及的两个参数： INT_MAX数据类型INT的最大值，其值为2147483647。 DBL_MAX数据类型FLOAT的最大值。 全局设置查询规划相关参数除了客户业务外也会对数据库自身运维和监控业务造成影响，如WDR报告生成、扩容、重分布、数据导入导出等。 优化器方法配置 优化器开销常量 基因查询优化器 其他优化器选项 父主题： GUC参数说明

check_sync_standby 参数说明：打开备机检查开关，主备场景下配置了正确的synchronous_standby_names参数后，当同步备故障时，主机写业务直接报错写失败。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：on/off on表示开启备机检查。 off表示关闭备机检查。 默认值：off 该参数不支持在job work和自治事务中同步，有可能导致检查不生效。 若指定用户或session中未设置备机检查，开启强同步提交模式下备机故障，执行一个表的写操作会导致另一个用户或session中的同一个表的查询hang，此时需要备机恢复或者手动terminate hang住的客户端。 不支持非写操作中触发写日志的场景中（vacuum analyze等）开启备机检查开关。若备机不满足同步备配置，则该场景会导致业务hang，需要手动terminate。

hadr_recovery_time_target 参数说明：在流式容灾模式下设置hadr_recovery_time_target能够让备数据库实例完成日志写入和回放。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~3600 （秒） 0是指不开启日志流控，1~3600是指备机能够在hadr_recovery_time_target时间内完成日志的写入和回放，可以保证主数据库实例与备数据库实例切换时能够在hadr_recovery_time_target秒完成日志写入和回放，保证备数据库实例能够快速升主。hadr_recovery_time_target设置时间过小会影响主机的性能，设置过大会失去流控效果。 默认值：0

enable_data_replicate 参数说明：当数据库在数据导入行存表时，主机与备机的数据同步方式可以进行选择。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示导入数据行存表时主备数据采用数据页的方式进行同步。当replication_type参数为1时，不允许设置为on，如果此时用guc工具设置成on，会强制改为off。 off表示导入数据行存表时主备数据采用日志（xLog）方式进行同步。 默认值：off

catchup2normal_wait_time 参数说明：打开最大可用模式most_available_sync，主备场景下，控制备机数据追赶（catchup）阻塞主机的最长时间。该时间为估算值，实际结果可能与参数值有偏差。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，范围-1~10000，单位为毫秒。 -1表示主机阻塞直到备机数据追赶完成。 0表示备机数据追赶时始终不阻塞主机。 其余值表示备机数据追赶时阻塞主机的最长时间。例如，取值5000，表示当备机数据追赶完成时间还剩5s时，阻塞主机等待其完成。 默认值：-1

hadr_super_user_record_path 参数说明：该参数为流式异地容灾参数，表示备数据库实例中hadr_disaster用户的加密文件存放路径。该参数属于SIGHUP类型参数，请参考表1中方式对应设置方法进行设置。 修改建议：由流式容灾密码传递工具自动设置，不需要用户手动添加。 取值范围：字符串 默认值：NULL 在一个包含了主机、备机的数据库实例中，主机相对于备机是发送端，备机相对于主机是接收端。 发送端主动向接收端同步配置文件、接收端请求发送端同步配置文件是两个独立的事件，均会使得配置文件同步。若不希望配置文件同步，则需要在接收端配置为none_node，发送端若为备机只能配置为none_node，发送端若为主机，配置为none_node时主机与所有备机都不同步，为only_sync_node时仅与同步备同步，不与异步备同步。 配置参数同步的具体表现为，发送端发送配置文件，对接收端配置文件中的对应参数直接覆盖。若设置了配置文件需要同步的策略，则修改接收端配置参数后，发送端会立刻覆盖接收端的配置参数，使得接收端修改不生效。 即使设置了配置文件需要同步的策略，仍有部分配置参数不会被同步。包括："application_name", "audit_directory", "available_zone", "comm_control_port", "comm_sctp_port", "listen_addresses", "log_directory", "port", "replconninfo1", "replconninfo2", "replconninfo3", "replconninfo4", "replconninfo5", "replconninfo6", "replconninfo7", "replconninfo8", "replconninfo9", "replconninfo10", "replconninfo11", "replconninfo12", "replconninfo13", "replconninfo14", "replconninfo15", "replconninfo16", "replconninfo17", "replconninfo18", "ssl", "ssl_ca_file", "ssl_cert_file", "ssl_ciphers", "ssl_crl_file", "ssl_key_file", "ssl_renegotiation_limit", "ssl_cert_notify_time", "synchronous_standby_names", "local_bind_address", "perf_directory", "query_log_directory", "asp_log_directory", "streaming_router_port", "enable_upsert_to_merge", "recovery_min_apply_delay", "sync_config_strategy"。

hadr_recovery_point_target 参数说明：在流式容灾模式下设置hadr_recovery_point_target能够让备数据库实例完成日志刷盘的rpo时间。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~3600 （秒） 0是指不开启日志流控，1~3600是指备机能够在hadr_recovery_point_target时间内完成日志的刷盘，可以保证主数据库实例与备数据库实例切换时日志差距能够在hadr_recovery_point_target秒内，保障备数据库实例升主日志量。hadr_recovery_point_target设置时间过小会影响主机的性能，设置过大会失去流控效果。 默认值：0

vacuum_defer_cleanup_age 参数说明：指定VACUUM使用的事务数，VACUUM会延迟清除无效的行存表记录，延迟的事务个数通过vacuum_defer_cleanup_age进行设置。即VACUUM和VACUUM FULL操作不会立即清理刚刚被删除元组。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0～1000000，值为0表示不延迟。 默认值：0

sync_config_strategy 参数说明：主机和备机、备机和级联备之间配置文件的同步策略。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：枚举类型 all_node: 主机配置为all_node时，表示允许主机向所有备机主动同步配置文件；备机配置为all_node时，表示允许当前备机向其主机发送同步请求，允许当前备机向其所有级联备主动同步配置文件；级联备配置为all_node时，表示允许当前级联备向其备机发送同步请求。 only_sync_node: 主机配置为only_sync_node时，表示仅允许主机向所有同步备机主动同步配置文件；备机配置为only_sync_node时，表示允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为only_sync_node时，表示允许当前级联备向其备机发送同步请求。 none_node: 主机配置为none_node时，表示不允许主机向任何备机主动同步配置文件；备机配置为none_node时，表示不允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为none_node时，表示不允许当前级联备向其备机发送同步请求。 默认值：all_node

keep_sync_window 参数说明：延迟进入最大可用模式的时间 当最大可用模式most_available_sync配置为on，在主备场景下，当存在同步备发生故障, 导致不满足当前所配置的同步备数量（详细可参考synchonous_standby_name的含义）时, 如果配置了keep_sync_window参数，则在keep_sync_window设置的时间窗口内，继续保持最大保护模式，即阻塞主机的事务提交，延缓进入最大可用模式的时间。 若在keep_sync_window超时窗口内，同步备机故障恢复，且满足当前所配置的同步备数量, 则不阻塞事务, 恢复到正常状态. 如果设置keep_sync_window，推荐最小配置为5s，以避免监控系统监控到网络不稳定的误报。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，范围0~INT_MAX，单位为秒 0表示不设置keep_sync_window超时时间窗口, 即直接进入最大可用模式。 其余表示keep_sync_window超时时间窗口的大小。 默认值：0 配置该参数可能会对RPO造成影响，若主机在所配置的超时时间窗口内发生故障，则从开始阻塞到主机故障这段时间窗口内的数据可能丢失。

most_available_sync 参数说明：在有同步备机故障时，主机事务不因同步备机故障而被阻塞。比如有两个同步备机，一个故障，另一个正常，这个时候主机事务只会等好的这个同步备，而不被故障的同步备所阻塞； 再比如执行quorum协议时，一主三同步备，配置ANY 2(node1,node2,node3)，当node1、node3故障，node2正常时，主机业务同样不被阻塞。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示在所有同步备机故障时，不阻塞主机。 off表示在所有同步备机故障时，阻塞主机。 默认值：off