华为云用户手册

云数据库 GaussDB-发送端服务器:wal_keep_segments

wal_keep_segments 参数说明：“pg_xlog”目录下保留事务日志文件的最小数目。备机通过获取主机此处的日志进行流复制。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，2 ~ INT_MAX 默认值：128 设置建议：当服务器开启日志归档或者从检查点恢复时，保留的日志文件数量可能大于wal_keep_segments设定的值。如果此参数设置过小，则在备机请求事务日志时，此事务日志可能已经被产生的新事务日志覆盖，导致请求失败，主备关系断开。当双机为异步传输时，以COPY方式连续导入4G以上数据需要增大wal_keep_segments配置。以T6000单板为例，如果导入数据量为50G，建议调整参数为1000。您可以在导入完成并且日志同步正常后，动态恢复此参数设置。

云数据库 GaussDB
云数据库 GaussDB-发送端服务器:wal_sender_timeout

wal_sender_timeout 参数说明：设置本端等待事务日志接收端接收日志的最大等待时间。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。如果主机数据较大，重建操作需要增大此参数的值，主机数据在500GB时，此参数的参考值为600s。此值不能大于wal_receiver_timeout或数据库重建时的超时参数。取值范围：整型，0 ~ 2147483647‬，单位为毫秒（ms）。默认值：6s

云数据库 GaussDB
云数据库 GaussDB-CREATE CONVERSION:注意事项

注意事项参数DEFAULT将在客户端和服务器之间默认执行源编码到目标编码之间的转换。要支持这个用法，需要定义双向转换，即从A到B和从B到A之间的转换。创建转换需拥有函数的EXECUTE权限及目标模式的CREATE权限。源编码和目标编码都不可以使用SQL_ASCII，因为在涉及SQL_ASCII “encoding”的情况下，服务器的行为是硬连接的。使用DROP CONVERSION可以移除用户定义的转换。

云数据库 GaussDB
云数据库 GaussDB-CREATE CONVERSION:参数说明

参数说明 DEFAULT DEFAULT子句表示这个转换是从源编码到目标编码的默认转换。在一个模式中对于每一个编码对，只应该有一个默认转换。 name 转换的名称，可以被模式限定。如果没有被模式限定，该转换被定义在当前模式中。在一个模式中，转换名称必须唯一。 source_encoding 源编码名称。 dest_encoding 目标编码名称。 function_name 被用来执行转换的函数。函数名可以被模式限定。如果没有，将在路径中查找该函数。该函数必须具有以下格式： conv_proc( integer, -- 原编码ID integer, -- 目标编码ID cstring, -- 源字符串（空值终止的C字符串） internal, -- 目标（用一个空值终止的C字符串填充） integer, -- 源字符串长度 ) RETURNS void; 目前仅支持系统内部创建，用户无法创建。

云数据库 GaussDB
云数据库 GaussDB-基因查询优化器:geqo

geqo 参数说明：控制基因查询优化的使用。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。通常情况下在执行过程中不要关闭，geqo_threshold变量提供了更精细的控制GEQO的方法。若该参数通过执行gs_guc reload修改时，如果当前节点上的某个session的连接不是来自于客户端，而是来自于该节点所属集群上的其他节点，那么执行gs_guc reload后该参数在该session上不会立即生效，需与连接节点断开连接后重新连接才会生效。取值范围：布尔型 on表示使用。 off表示不使用。默认值：on

云数据库 GaussDB
云数据库 GaussDB-基因查询优化器:geqo_threshold

geqo_threshold 参数说明：如果执行语句的数量超过设计的FROM的项数，则会使用基因查询优化来执行查询。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。对于简单的查询，通常用详尽搜索方法，当涉及多个表的查询的时候，用GEQO可以更好的管理查询。一个FULL OUTER JOIN构造仅作为一个FROM项。取值范围：整型，2～2147483647‬。默认值：12

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

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

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

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

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

router 参数说明：用于控制router功能的详细属性，仅在打开enable_router和enable_light_proxy后生效。该参数会根据表的hash分布列，计算给定的分布列在哪个DN上，设置router后将支持的sql下推到该DN上执行。如果设置错了router，可能导致数据存入错误的dn，导致不可预测的问题，需谨慎使用。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串该参数分为两部分，'schema_name.table_name,"distribute_keys"'，其具体含义如下： schema_name.table_name：表示schema名和表名，如不显示设置schema_name，则默认为current_schema。 distribute_keys：分布表的所有分布列值，用逗号间隔开，且分布列值的顺序必须和表中分布列顺序一致。默认值：空

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

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

云数据库 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-其他优化器选项:cursor_tuple_fraction

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

云数据库 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_fast_numeric

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

云数据库 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-其他优化器选项:query_dop

query_dop 参数说明：用户自定义的查询并行度。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，-64-64 [1,64]：打开固定SMP功能，系统会使用固定并行度。 0：打开SMP自适应功能，系统会根据资源情况和计划特征动态选取最优并行度。 [-64,-1]：打开SMP自适应功能，并限制自适应选取的最大并行度。在开启并行查询后，请保证系统CPU、内存、网络、I/O等资源充足，以达到最佳效果。为了避免用户设置不合理的过大值造成性能劣化，系统会计算出该DN可用最大CPU核数，并以此来作为query_dop的上限。如果用户设置query_dop超过4并且同时超过该上限，那么系统会重置query_dop为该上限值。默认值：1

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

enable_sonic_optspill 参数说明：标识是否对面向列的hash表设计的Hash Join算子进行下盘文件数优化。该参数打开时，在Hash Join算子下盘文件较多的时候，下盘文件数不会显著增加。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示优化面向列的hash表设计的Hash Join算子的下盘文件数。 off表示不优化面向列的hash表设计的Hash Join算子的下盘文件数。默认值：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_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-其他优化器选项:plan_mode_seed

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不会生效。

云数据库 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-其他优化器选项:join_collapse_limit

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

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

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

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

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

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

analysis_options 参数说明：通过开启对应选项中所对应的功能选项使用相应的定位功能，包括数据校验，性能统计等，参见取值范围中的选项说明。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串 HASH_CONFLICT表示在DN进程的pg_log目录中的log日志中显示hash表的统计信息，包括hash表大小，hash链长，hash冲突情况。 STREAM_DATA_CHECK表示对网络传输前后的数据进行CRC校验。默认值：ALL,on(),off(HASH_CONFLICT,STREAM_DATA_CHECK)，不开启任何定位功能。

云数据库 GaussDB
云数据库 GaussDB-记录日志的时间:log_min_error_statement

log_min_error_statement 参数说明：控制在服务器日志中记录错误的SQL语句。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。取值范围：枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表1。设置为error ，表示导致错误、日志消息、致命错误、panic的语句都将被记录。设置为panic，表示关闭此特性。默认值：error

云数据库 GaussDB
云数据库 GaussDB-记录日志的时间:log_min_duration_statement

log_min_duration_statement 参数说明：当某条语句的持续时间大于或者等于特定的毫秒数时，log_min_duration_statement参数用于控制记录每条完成语句的持续时间。设置log_min_duration_statement可以很方便地跟踪需要优化的查询语句。对于使用扩展查询协议的客户端，语法分析、绑定、执行每一步所花时间被独立记录。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。当此选项与log_statement同时使用时，已经被log_statement记录的语句文本不会被重复记录。在没有使用syslog情况下，推荐使用log_line_prefix记录PID或会话ID，方便将当前语句消息连接到最后的持续时间消息。取值范围：整型，-1 ~ 2147483647‬，单位为毫秒。设置为250，所有运行时间不短于250ms的SQL语句都会被记录。设置为0，输出所有语句的持续时间。设置为-1，关闭此功能。默认值：3s（即3000ms）

云数据库 GaussDB
云数据库 GaussDB-记录日志的时间:backtrace_min_messages

backtrace_min_messages 参数说明：控制当产生该设置参数级别相等或更高级别的信息时，会打印函数的堆栈信息到服务器日志文件中。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。该参数作为客户现场问题定位手段使用，且由于频繁的打印函数栈会对系统的开销及稳定性有一定的影响，因此如果需要进行问题定位时，建议避免将backtrace_min_messages的值设置为fatal及panic以外的级别。取值范围：枚举类型有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表1。默认值：panic

云数据库 GaussDB
云数据库 GaussDB-记录日志的时间:log_min_messages

log_min_messages 参数说明：控制写到服务器日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。当client_min_messages和log_min_messages取相同值log时所代表的消息级别不同。取值范围：枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic，其中debug和debug2等效。参数的详细信息请参见表1。默认值：warning

云数据库 GaussDB

共99354条

undefined

意见反馈

0/200

提交取消

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

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线