华为云用户手册

云数据库 GaussDB-其他优化器选项:session_sequence_cache

session_sequence_cache 参数说明：在当前会话下，一次性交互申请的sequence数值，会话结束会自动丢弃未用完的值。用户在使用sequence大批量导入数据的时候可以通过调大该参数，提高插入速度，增加高并发性能；用户在高并发单条插入数据的时候，将该参数设置为1，减少了sequence的跳变。如对连续性有强要求，需要在创建sequence的时候指定需要的cache，该参数如果大于cache指定的值会自动失效。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，1 ~ 2147483647。默认值：10 默认值为10是高并发场景下，兼顾单条插入和批量插入的性能会有比较好的表现。

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:constraint_exclusion

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

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:join_collapse_limit

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

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:enable_fast_numeric

enable_fast_numeric 参数说明：标识是否开启Numeric类型数据运算优化。Numeric数据运算是较为耗时的操作之一，通过将Numeric转化为int64/int128类型，提高Numeric运算的性能。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on/true表示开启Numeric优化。 off/false表示关闭Numeric优化。默认值：on

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:enable_opfusion

enable_opfusion 参数说明：控制是否对简单查询进行查询优化。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。该开关是优化DN的查询性能，可以设置max_datanode_for_plan查看一个查询DN的执行计划，如果DN的执行计划中带有[Bypass]标识则代表该查询在该DN可以查询优化。简单查询限制如下：只支持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

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:enable_partition_opfusion

enable_partition_opfusion 参数说明：在enable_opfusion参数打开的状态下，如果开启该参数，可以对分区表的简单查询进行查询优化，提升SQL执行性能。在enable_global_plancache参数设置为on时，此参数设置on将不生效。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示使用。 off表示不使用。默认值：off

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:cost_param

cost_param 参数说明：该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。当cost_param & 1不为0，表示对于求不等值连接选择率时选择一种改良机制，此方法在自连接（两个相同的表之间连接）的估算中更加准确。当前版本已弃用cost_param & 1不为0时的路径，默认选择更优的估算公式。当cost_param & 2不为0，表示求多个过滤条件（Filter）的选择率时，选择最小的作为总的选择率，而非两者乘积，此方法在过滤条件的列之间关联性较强时估算更加准确。当cost_param & 4不为0，表示在进行stream节点估算时，选用调试模型，该模型不推荐用户使用。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0～2147483647‬ 默认值：0

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:enable_gpc_grayrelease_mode

enable_gpc_grayrelease_mode 参数说明：分布式集群下，开启GPC需要重启集群。如果需要在不重启集群的情况下开启GPC，需要用enable_gpc_grayrelease_mode控制滚动开启GPC或关闭GPC。分布式集群上操作方式。开启GPC： 1、在所有DN节点开启enable_gpc_grayrelease_mode。 2、在所有CN节点开启enable_gpc_grayrelease_mode。 3、开启GPC参数，由于GPC是POSTMASTER参数，需要先reload参数，之后轮询kill节点，使重新拉起的节点上GPC生效。关闭GPC： 1、首先确定enable_gpc_grayrelease_mode 是on的状态，reload关闭GPC参数，然后轮询kill节点，使重新拉起的节点上GPC生效。 2、在所有CN节点关闭enable_gpc_grayrelease_mode。 3、在所有DN节点关闭enable_gpc_grayrelease_mode。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型。 on off 默认值：off

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:enable_global_stats

enable_global_stats 参数说明：标识当前统计信息模式，区别采用全局统计信息收集模式还是单节点统计信息收集模式，默认创建为采用全局统计信息模式。当关闭该参数时，则默认收集集群第一个节点的统计信息，此时可能会影响生成查询计划的质量，但信息收集性能较优，建议谨慎设置。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on/true表示全局统计信息。 off/false表示单DN统计信息。默认值：on

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:explain_perf_mode

explain_perf_mode 参数说明：此参数用来指定explain的显示格式。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：normal、pretty、summary、run normal：代表使用默认的打印格式。 pretty：代表使用GaussDB改进后的新显示格式。新的格式层次清晰，计划包含了plan node id，性能分析简单直接。 summary：是在pretty的基础上增加了对打印信息的分析。 run：在summary的基础上，将统计的信息输出到csv格式的文件中，以便于进一步分析。默认值：pretty pretty模式当前只支持包含stream算子的计划，不支持下发语句到DN节点的计划。因此显示格式会受enable_stream_operator参数影响，当enable_stream_operator设置为off时无法生成包含stream算子的计划。

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:enable_global_plancache

enable_global_plancache 参数说明：设置是否对PBE查询和存储过程中语句的执行计划进行缓存共享，开启该功能可以节省高并发下CN和DN上的内存使用。且该参数必须在CN和DN上一致，否则会出现CN下发给DN的报文不匹配从而报错等问题。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。在打开enable_global_plancache的情况下，为保证GPC生效，默认local_syscache_threshold不小于16MB。即如当前local_syscache_threshold小于16MB，则设置为16MB，如大于16MB，则不改变。取值范围：布尔型。 on表示对PBE查询和存储过程中语句的执行计划进行缓存共享。 off表示不共享。默认值：off

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:cursor_tuple_fraction

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

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:analysis_options

analysis_options 参数说明：通过开启对应选项中所对应的功能选项使用相应的定位功能，包括数据校验，性能统计等，参见取值范围中的选项说明。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串 LLVM_COMPILE表示在explain performance显示界面中显示每个线程的codegen编译时间，当前特性是实验室特性，使用时请联系华为工程师提供技术支持。。 HASH_CONFLICT表示在DN进程的pg_log目录中的log日志中显示hash表的统计信息，包括hash表大小，hash链长，hash冲突情况。 STREAM_DATA_CHECK表示对网络传输前后的数据进行CRC校验。默认值：ALL,on(),off(LLVM_COMPILE,HASH_CONFLICT,STREAM_DATA_CHECK)，不开启任何定位功能。

云数据库 GaussDB
云数据库 GaussDB-其他优化器选项:cost_model_version

cost_model_version 参数说明：此参数用来指定优化器代价模型的版本。可以视作一个保护参数，用来禁用最新的优化器代价模型，保持和旧版本计划一致。改变此参数，可能会导致很多SQL计划的改变，因此修改前请谨慎评估。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：0、1、2、3 0：表示使用最新的cost估算模型。当前版本等价于3。 1：表示使用原始的cost估算模型。 2：表示在1的基础上，使用增强的coalesce表达式估算、hash join代价估算、semi/anti join代价估算。 3：表示在2的基础上，使用边界矫正估计器估算NDV，indexscan的hint可以作用于indexonlyscan。默认值：0

云数据库 GaussDB
云数据库 GaussDB-查询和索引统计收集器:track_io_timing

track_io_timing 参数说明：控制收集数据库I/O调用时序的统计数据。I/O时序统计数据可以在pg_stat_database中查询。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示开启收集功能，开启时，收集器会在重复地去查询当前时间的操作系统，这可能会引起某些平台的重大开销，故默认值设置为off。 off表示关闭收集功能。默认值：off

云数据库 GaussDB
云数据库 GaussDB-查询和索引统计收集器:track_functions

track_functions 参数说明：控制收集函数的调用次数和调用耗时的统计数据。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。当SQL语言函数设置为调用查询的“内联”函数时，不管是否设置此选项，这些SQL语言函数无法被追踪到。取值范围：枚举类型 pl表示只追踪过程语言函数。 all表示追踪SQL和C语言函数（当前特性是实验室特性，使用时请联系华为工程师提供技术支持）。 none表示关闭函数追踪功能。默认值：none

云数据库 GaussDB
云数据库 GaussDB-查询和索引统计收集器:track_sql_count

track_sql_count 参数说明：控制对每个会话中当前正在执行的SELECT、INSERT、UPDATE、DELETE、MERGE INTO语句进行计数的统计数据。在x86架构集中式部署下，硬件配置规格为32核CPU/256GB内存，使用Benchmark SQL 5.0工具测试性能, 开关此参数性能影响约0.8%。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示开启计数功能。 off表示关闭计数功能。默认值：on 当参数关闭时，查询视图的结果为0行。

云数据库 GaussDB
云数据库 GaussDB-查询和索引统计收集器:enable_save_datachanged_timestamp

enable_save_datachanged_timestamp 参数说明：确定是否收集insert/update/delete, exchange/truncate/drop partition操作对表数据改动的时间。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示允许收集相关操作对表数据改动的时间。 off表示禁止收集相关操作对表数据改动的时间。默认值：on

云数据库 GaussDB
云数据库 GaussDB-查询和索引统计收集器:track_activities

track_activities 参数说明：控制收集每个会话中当前正在执行命令的统计数据。对于存储过程，打开该参数后，可以通过pg_stat_activity视图看到存储过程内正在执行的perform语句、调用存储过程语句、存储过程内的SQL语句、OPEN CURSOR语句。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示开启收集功能。 off表示关闭收集功能。默认值：on

云数据库 GaussDB
云数据库 GaussDB-自动清理:autovacuum_max_workers

autovacuum_max_workers 参数说明：设置能同时运行的自动清理线程的最大数量，该参数的取值上限与GUC参数max_connections和job_queue_processes大小有关。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - max_inner_tool_connections - max_connections - max_concurrent_autonomous_transactions - job_queue_processes - 辅助线程数 – autovacuum的launcher线程数 - 1”，其中辅助线程数和autovacuum的launcher线程数由两个宏来指定，当前版本的默认值分别为20和2。默认值：3

云数据库 GaussDB
云数据库 GaussDB-自动清理:log_autovacuum_min_duration

log_autovacuum_min_duration 参数说明：当自动清理的执行时间大于或者等于某个特定的值时，向服务器日志中记录自动清理执行的每一步操作。设置此选项有助于追踪自动清理的行为。举例如下：将log_autovacuum_min_duration设置为250ms，表示记录所有运行大于或者等于250ms的自动清理命令的相关信息。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，最小值为-1，最大值为2147483647，单位为毫秒。当参数设置为0时，表示所有的自动清理操作都记录到日志中。当参数设置为-1时，表示所有的自动清理操作都不记录到日志中。当参数设置为非-1时，当由于锁冲突的存在导致一个自动清理操作被跳过，记录一条消息。默认值：-1

云数据库 GaussDB
云数据库 GaussDB-自动清理:autoanalyze_timeout

autoanalyze_timeout 参数说明：设置autoanalyze的超时时间。在对某张表做autoanalyze时，如果该表的analyze时长超过了autoanalyze_timeout，则自动取消该表此次analyze。这里的时间检查不能保证完全精确，原则上要保证各个CN上统计信息一致，因此在CN间同步信息时，即便超时也不会被打断。这导致实际的执行时间有可能超过用户定义的时间。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，单位是s，0~2147483，0表示不超时。默认值：5min（即300s）

云数据库 GaussDB
云数据库 GaussDB-自动清理:autovacuum_analyze_threshold

autovacuum_analyze_threshold 参数说明：设置触发ANALYZE操作的阈值。当表上被删除、插入或更新的记录数超过设定的阈值时才会对这个表执行ANALYZE操作。若表上存在全局二级索引，则当表上被删除、插入和更新的记录数超过该阈值的20倍时才会对全局二级索引执行ANALYZE操作。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，最小值为0，最大值为2147483647。默认值：50

云数据库 GaussDB
云数据库 GaussDB-自动清理:autovacuum_freeze_max_age

autovacuum_freeze_max_age 参数说明：设置事务内的最大时间，使得表的pg_class.relfrozenxid字段在VACUUM操作执行之前被写入。 VACUUM也可以删除pg_clog/子目录中的旧文件。即使自动清理线程被禁止，系统也会调用自动清理线程来防止循环重复。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：长整型，100 000～576 460 752 303 423 487 默认值：4000000000

云数据库 GaussDB
云数据库 GaussDB-自动清理:autovacuum_mode

autovacuum_mode 参数说明：该参数仅在autovacuum设置为on的场景下生效，它控制autoanalyze或autovacuum的打开情况。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：枚举类型 analyze表示只做autoanalyze。 vacuum表示只做autovacuum。 mix表示autoanalyze和autovacuum都做。 none表示二者都不做。默认值：mix

云数据库 GaussDB
云数据库 GaussDB-自动清理:autovacuum

autovacuum 参数说明：控制数据库自动清理线程（autovacuum）的启动。自动清理线程运行的前提是将track_counts设置为on。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。如果希望系统在故障恢复后，具备自动清理两阶段事务的功能，请将autovacuum设置为on; 当设置autovacuum为on，autovacuum_max_workers为0时，表示系统不会自动进行autovacuum，只会在故障恢复后，自动清理两阶段事务；当设置autovacuum为on，autovacuum_max_workers大于0时，表示系统不仅在故障恢复后，自动清理两阶段事务，并且还可以自动清理线程。取值范围：布尔型 on表示开启数据库自动清理线程。 off表示关闭数据库自动清理线程。默认值：on

云数据库 GaussDB
云数据库 GaussDB-记录日志的内容:opfusion_debug_mode

opfusion_debug_mode 参数说明：用于调试简单查询是否进行查询优化。设置成log级别可以在DN的执行计划中看到没有查询优化的具体原因。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：枚举类型 off表示不打开该功能。 log表示打开该功能，可以在DN的执行计划中看到没有查询优化的具体原因。需要设置参数max_datanode_for_plan才能看到DN的执行计划。提供在log中显示语句没有查询优化的具体原因，需要将参数设置成log级别，log_min_messages设置成debug4级别，logging_module设置'on(OPFUSION)'，注意log内容可能会比较多，尽可能在调优期间执行少量作业使用。默认值：off

云数据库 GaussDB
云数据库 GaussDB-记录日志的内容:resource_track_log

resource_track_log 参数说明：控制自诊断的日志级别。目前仅对多列统计信息进行控制。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串 summary：显示简略的诊断信息。 detail：显示详细的诊断信息。目前这两个参数值只在显示多列统计信息未收集的告警的情况下有差别，summary不显示未收集多列统计信息的告警，detail会显示这类告警。默认值：summary

云数据库 GaussDB
云数据库 GaussDB-记录日志的内容:enable_unshipping_log

enable_unshipping_log 参数说明：用于控制是否打印语句不下推的日志，主要用于帮助用户定位不下推语句可能导致的性能问题。当enable_stream_operator参数关闭时，如果这个参数设置为on，会有大量关于计划不能下推的日志记录到日志文件中。如果用户不需要这些日志内容，建议用户在enable_stream_operator参数关闭时，也同时关闭enable_unshipping_log参数。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示打印日志。 off表示不打印日志。默认值：off

云数据库 GaussDB
云数据库 GaussDB-记录日志的内容:log_line_prefix

log_line_prefix 参数说明：控制每条日志信息的前缀格式。日志前缀类似于printf风格的字符串，在日志的每行开头输出。用以%为开头的“转义字符”代替表1中的状态信息。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。表1 转义字符表转义字符效果 %a 应用程序名称。 %u 用户名。 %d 数据库名。 %r 远端主机名或者IP地址以及远端端口，在不启动log_hostname时显示IP地址及远端端口。 %h 远端主机名或者IP地址，在不启动log_hostname时只显示IP地址。 %p 线程ID。 %t 时间戳（没有毫秒，Windows上没有时区）。 %m 带毫秒的时间戳。 %n 表示指定错误从哪个节点上报的。 %i 命令标签：会话当前执行的命令类型。 %e SQLSTATE错误码。 %c 会话ID，详见说明。 %l 每个会话的日志编号，从1开始。 %s 会话启动时间。 %v 虚拟事务ID（backendID/ localXID） %x 事务ID（0表示没有分配事务ID）。 %q 不产生任何输出。如果当前线程是后端线程，忽略这个转义序列，继续处理后面的转义序列；如果当前线程不是后端线程，忽略这个转义序列和它后面的所有转义序列。 %S 会话ID。 %T TraceID。 %% 字符%。转义字符%c打印一个唯一的会话ID，由两个4字节的十六进制数组成，通过字符“.”分开。这两个十六进制数分别表示进程的启动时间及进程编号，所以%c也可以看作是保存打印这些名目的途径的空间。比如，从pg_stat_activity中产生会话ID，可以用下面的查询： 123 SELECT to_hex(EXTRACT(EPOCH FROM backend_start)::integer) || '.' || to_hex(pid)FROM pg_stat_activity; 当log_line_prefix设置为非空值时，请保证最后一个字符是一个空格，以此来直观地与后续的日志行进行区分，也可以使用一个标点符号。 Syslog生成自己的时间戳及进程ID信息，所以当登录日志时，不需要包含这些转义字符。取值范围：字符串默认值：'%m %n %u %d %h %p %S %x %a ' %m %n %u %d %h %p %S %x %a 表示会话开始时间戳、错误上报节点、用户名、数据库名、远程主机名或IP、线程ID、会话ID、事务ID、应用名。

云数据库 GaussDB

共100000条

undefined

意见反馈

0/200

提交取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线