其他优化器选项
explain_dna_file
参数说明:指定explain_perf_mode为run,导出的csv信息的目标文件。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
这个参数的取值必须是绝对路径加上.csv格式的文件名。
取值范围:字符串
默认值:空
explain_perf_mode
参数说明:此参数用来指定explain的显示格式。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:normal、pretty、summary、run
- normal:代表使用默认的打印格式。
- pretty:代表使用GaussDB改进后的新显示格式。新的格式层次清晰,计划包含了plan node id,性能分析简单直接。
- summary:是在pretty的基础上增加了对打印信息的分析。
- run:在summary的基础上,将统计的信息输出到csv格式的文件中,以便于进一步分析。
默认值:pretty(当前版本参数取值仅normal生效,若设置为非normal,显示格式依然为normal)
pretty模式只展示一个计划。使用create rule创建规则后执行的SQL语句可能产生多个计划,此时建议使用normal模式。
用例如下:
openGauss=# CREATE TABLE another_table (id int, name text); CREATE TABLE openGauss=# CREATE TABLE my_table (id int, name text); CREATE TABLE openGauss=# CREATE RULE my_rule AS ON INSERT TO my_table openGauss-# WHERE NEW.id > 5 openGauss-# DO INSTEAD (INSERT INTO another_table VALUES (NEW.id, 'Some Data');); CREATE RULE openGauss=# explain INSERT INTO my_table VALUES (5, 'Test Name'); QUERY PLAN ----------------------------------------------------------- Insert on my_table (cost=0.00..0.01 rows=1 width=0) -> Result (cost=0.00..0.01 rows=1 width=0) Insert on another_table (cost=0.00..0.01 rows=1 width=0) -> Result (cost=0.00..0.01 rows=1 width=0) One-Time Filter: false (6 rows) openGauss=# set explain_perf_mode=pretty; SET openGauss=# explain INSERT INTO my_table VALUES (5, 'Test Name'); id | operation | E-rows | E-width | E-costs ----+-----------------------------+--------+---------+-------------- 1 | -> Insert on another_table | 1 | 0 | 0.000..0.010 2 | -> Result | 1 | 0 | 0.000..0.010 (2 rows) Predicate Information (identified by plan id) ----------------------------------------------- 2 --Result One-Time Filter: false (2 rows) openGauss=# drop table my_table; DROP TABLE openGauss=# drop table another_table; DROP TABLE
analysis_options
参数说明:通过开启对应选项中所对应的功能选项使用相应的定位功能,包括数据校验、性能统计等,参见取值范围中的选项说明。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:字符串
- HASH_CONFLICT表示在数据库节点进程的pg_log目录中的log日志中显示hash表的统计信息,包括hash表大小、hash链长、hash冲突情况。
- STREAM_DATA_CHECK表示对网络传输前后的数据进行CRC校验。
默认值:ALL,on(),off(HASH_CONFLICT,STREAM_DATA_CHECK),不开启任何定位功能。
cost_param
参数说明:该参数用于控制在特定的客户场景中,使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法,与某一方法对应的位做与操作,不为0表示该方法被选择。
当cost_param & 1 不为0,表示对于求不等值连接选择率时选择一种改良机制,此方法在自连接(两个相同的表之间连接)的估算中更加准确。目前,已弃用cost_param & 1 不为0时的路径,默认选择更优的估算公式;
当cost_param & 2 不为0,表示求多个过滤条件(Filter)的选择率时,选择最小的作为总的选择率,而非两者乘积,此方法在过滤条件的列之间关联性较强时估算更加准确;
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:整型,0~INT_MAX
默认值:0
enable_partitionwise
参数说明:分区表连接操作是否选择智能算法。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on表示选择智能算法。
- off表示不选择智能算法。
默认值:off
rewrite_rule
参数说明:标识已开启的可选查询重写规则。有部分查询重写规则是可选的,开启它们并不能总是对查询效率有提升效果。在特定的客户场景中,通过此GUC参数对查询重写规则进行设置,使得查询效率最优。
此参数可以控制查询重写规则的组合,比如有多个重写规则:rule1、rule2、rule3、rule4。可以设置:
set rewrite_rule=rule1; --启用查询重写规则rule1 set rewrite_rule=rule2,rule3; --启用查询重写规则rule2和rule3 set rewrite_rule=none; --关闭所有可选查询重写规则
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:字符串
- none:不使用任何可选查询重写规则。
- lazyagg:使用Lazy Agg查询重写规则(消除子查询中的聚集运算)。
- magicset:使用Magic Set查询重写规则(将带有聚集算子的子查询提前和主查询进行关联,减少子链接的重复扫描)。
- uniquecheck:使用Unique Check查询重写规则(提升目标列中无agg的子查询语句,在执行时检查返回行数是否为1行)。
- intargetlist:使用In Target List查询重写规则(提升目标列中的子查询)。
- predpushnormal:使用Predicate Push查询重写规则(下推谓词条件到子查询中)。
- predpushforce:使用Predicate Push查询重写规则(下推谓词条件到子查询中,尽可能的利用索引加速)。
- predpush:在predpushnormal和predpushforce中根据代价选择最优计划。
- disable_pullup_expr_sublink:禁止优化器将expr_sublink类型的子连接提升,关于sublink的分类和提升原理详见《开发指南》中的“SQL调优指南 > 典型SQL调优点 > 子查询调优”章节。
- disable_pullup_not_in_sublink:禁止优化器对not in相关的子链接进行提升,关于sublink的分类和提升原理详见《开发指南》中的“SQL调优指南 > 典型SQL调优点 > 子查询调优”章节。
- enable_sublink_pullup_rownum:允许SQL语句中有ROWNUM伪列的情况下优化器进行子链接提升。
默认值:magicset
当前版本可以设置partialpush、disablerep参数,但实际不生效。
enable_pbe_optimization
参数说明:设置优化器是否对以PBE(Parse Bind Execute)形式执行的语句进行查询计划的优化。
该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型。
- on表示优化器将优化PBE语句的查询计划。
- off表示不使用优化。
默认值:on
enable_global_stats
参数说明:标识当前统计信息模式,区别采用全局统计信息收集模式还是单节点统计信息收集模式,默认创建为采用全局统计信息模式。当关闭该参数时,则默认收集数据库第一个节点的统计信息,此时可能会影响生成查询计划的质量,但信息收集性能较优,建议谨慎设置。
该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on/true表示全局统计信息。
- off/false表示数据库节点统计信息。
默认值:on
集中式下该参数不生效。
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
sql_beta_feature
参数说明:标识开启的可选SQL引擎Beta特性,其中包括对行数估算、查询等价估算等优化。
开启它们可以对特定的场景进行优化,但也可能会导致部分没有被测试覆盖的场景发生性能劣化。在特定的客户场景中,通过此GUC参数对查询重写规则进行设置,使得查询效率最优。
此参数可以控制SQL引擎Beta特性的组合,比如有多个Beta特性:feature1、feature2、feature3、feature4。可以设置:
--启用SQL引擎Beta特性feature1。 set sql_beta_feature=feature1; --启用SQL引擎Beta特性feature2和feature3。 set sql_beta_feature=feature2,feature3; --关闭所有可选SQL引擎Beta特性。 set sql_beta_feature=none;
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:字符串
- none:不使用任何Beta优化器特性。
- sel_semi_poisson:使用泊松分布对等值的半连接和反连接选择率进行校准。
- sel_expr_instr:使用字符串匹配的行数估算方法对instr(col, 'const') > 0, = 0, = 1进行更准确的估算。
- param_path_gen:生成更多可能的参数化路径。
- rand_cost_opt:对小数据量表的随机读取代价进行优化。
- param_path_opt:利用表的膨胀系数优化索引analyze信息。
- page_est_opt:优化对表索引analyze信息的relpages估算。
- no_unique_index_first:关闭主键索引扫描路径优先的优化。
- join_sel_with_cast_func:估算join行数的时候支持类型转换函数。
- canonical_pathkey:正则化pathkey生成置前。(pathkey:标记数据有序性键值的集合)
- index_cost_with_leaf_pages_only:估算索引代价时考虑索引叶子节点。
- a_style_coerce:开启Decode类型转换规则兼容O,请参见《开发指南》中的“SQL参考 > 类型转换 > UNION,CASE和相关构造”章节中“对于case,在ORA兼容模式下的处理”。
- predpush_same_level:开启predpush hint控制同层参数化路径的功能。
- enable_plsql_smp:开启存储过程中的查询支持并行执行的功能。目前在同一时刻仅支持一条query使用并行执行,且cursor相关操作、自治事务、exception中的查询不会生成并行执行计划。
- disable_bitmap_cost_with_lossy_pages:关闭bitmap路径代价中对lossy pages代价的计算。
默认值:"sel_semi_poisson,sel_expr_instr,rand_cost_opt,param_path_opt,page_est_opt"
default_statistics_target
参数说明:为没有用ALTER TABLE SET STATISTICS设置字段目标的表设置缺省统计目标。影响收集统计信息时的采样行数。
此参数设置为正数时,代表统计信息直方图预期桶的数量,统计信息采样行数为default_statistics_target * 300;为负数时,代表使用百分比的形式设置统计目标,负数转换为对应的百分比,即-5代表5%,采样行数为总行数 * 5%。此参数仅影响统计信息的目标采样行数,实际采样行数还会受到内存参数work_mem的限制。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:整型,-100~10000。
- 比默认值大的正数数值增加了ANALYZE所需的时间,但是可能会改善优化器的估计质量。
- 调整此参数可能存在性能劣化的风险,如果某个查询劣化,可以考虑
- 恢复默认的统计信息。
- 使用plan hint来调整到之前的查询计划。(详细参见《开发指南》中“SQL调优指南 > 使用Plan Hint进行调优”章节)
- 当此guc参数设置为负数时,如果计算的采样样本数大于等于总数据量的2%,且用户表的数据量小于1600000时,ANALYZE所需时间相比guc参数为默认值的时间会有所增加。
- 当此guc参数设置为负数时,则autoanalyze不生效。
默认值:100
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
from_collapse_limit
参数说明:根据生成的FROM列表的项数来判断优化器是否将把子查询合并到上层查询,如果FROM列表项个数小于等于该参数值,优化器会将子查询合并到上层查询。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:整型,1~INT_MAX。
比默认值小的数值将降低规划时间,但是可能生成差的执行计划。
默认值:8
join_collapse_limit
参数说明:根据得出的列表项数来判断优化器是否执行把除FULL JOIN之外的JOIN构造重写到FROM列表中。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:整型,1~INT_MAX。
- 设置为1会避免任何JOIN重排。这样就使得查询中指定的连接顺序就是实际的连接顺序。查询优化器并不是总能选取最优的连接顺序,高级用户可以选择暂时把这个变量设置为1,然后指定它们需要的连接顺序。
- 比默认值小的数值减少规划时间但也降低了执行计划的质量。
默认值:8
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不会生效。
hashagg_table_size
参数说明:用于设置执行HASH JOIN操作时HASH表的大小。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:整型,0~INT_MAX/2。
默认值:0
enable_bloom_filter
参数说明:标识是否允许使用BloomFilter优化。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on表示允许使用BloomFilter优化。
- off表示不允许使用BloomFilter优化。
默认值:on
enable_extrapolation_stats
参数说明: 标识对于日期类型是否允许基于历史统计信息使用推理估算的逻辑。使用该逻辑对于未及时收集统计信息的表可以增大估算准确的可能性,但也存在错误推理导致估算过大的可能性,需要对于日期类型数据定期插入的场景开启此开关。
该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on表示允许基于历史统计信息使用推理估算的逻辑。
- off表示不允许基于历史统计信息使用推理估算的逻辑。
默认值:off
autoanalyze
参数说明:标识是否允许在生成计划的时候,对于没有统计信息的表进行统计信息自动收集。对于外表和临时表,不支持autoanalyze,如果需要收集统计信息,用户需手动执行analyze操作。如果在auto analyze某个表的过程中数据库发生异常,当数据库正常运行之后再执行语句有可能仍提示需要收集此表的统计信息。此时需要用户对该表手动执行一次analyze操作,以同步统计信息数据。
该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on表示允许自动进行统计信息收集。
- off表示不允许自动进行统计信息收集。
默认值:off
该参数与autovacuum线程下的autoanalyze无关。集中式下该参数不生效。
enable_analyze_check
参数说明: 标识是否允许在生成计划的时候,对于在pg_class中显示reltuples和relpages均为0的表,检查该表是否曾进行过统计信息收集。
该参数属于SUSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on表示允许检查。
- off表示不允许检查。
默认值:off
enable_sonic_hashagg
参数说明:标识是否依据规则约束使用基于面向列的hash表设计的Hash Agg算子。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on表示在满足约束条件时使用基于面向列的hash表设计的Hash Agg算子。
- off表示不使用面向列的hash表设计的Hash Agg算子。
- 在开启enable_sonic_hashagg,且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时,查询对应的Hash Agg算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景,对应的算子查询性能可能会出现劣化。
- 开启enable_sonic_hashagg,且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时,在Explain Analyze/Performance的执行计划和执行信息中,算子显示为“Sonic Hash Aggregation”,而未达到该约束条件时,算子名称将显示为“Hash Aggregation”,Explain详解请参见《开发指南》中“SQL调优指南 > SQL执行计划介绍 > 详解”章节。
默认值:on
enable_sonic_hashjoin
参数说明:标识是否依据规则约束使用基于面向列的hash表设计的Hash Join算子。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on表示在满足约束条件时使用基于面向列的hash表设计的Hash Join算子。
- off表示不使用面向列的hash表设计的Hash Join算子。
- 当前开关仅适用于Inner Join的场景。
- 在开启enable_sonic_hashjoin,查询对应的Hash Inner算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景,对应的算子查询性能可能会出现劣化。
- 开启enable_sonic_hashjoin,且查询达到约束条件使用基于面向列的hash表设计的Hash Join算子时,在Explain Analyze/Performance的执行计划和执行信息中,算子显示为“Sonic Hash Join”,而未达到该约束条件时,算子名称将显示为“Hash Join”,Explain详解请参见《开发指南》中“SQL调优指南 > SQL执行计划介绍 > 详解”章节。
默认值:on
enable_sonic_optspill
参数说明:标识是否对面向列的hash表设计的Hash Join算子进行下盘文件数优化。该参数打开时,在Hash Join算子下盘文件较多的时候,下盘文件数不会显著增加。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on表示优化面向列的hash表设计的Hash Join算子的下盘文件数。
- off表示不优化面向列的hash表设计的Hash Join算子的下盘文件数。
默认值:on
plan_cache_mode
参数说明:标识在prepare语句中,选择生成执行计划的策略。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:枚举类型
- auto表示按照默认的方式选择custom plan或者generic plan。
- force_generic_plan表示强制走generic plan(软解析)。generic plan是指对于prepare语句生成计划,该计划策略会在执行execute语句的时候把参数bind到plan中,然后执行计划。这种方案的优点是每次执行可以省去重复的优化器开销;缺点是当bind参数字段上数据存在倾斜时该计划可能不是最优的,部分bind参数场景下执行性能较差。
- force_custom_plan表示强制走custom plan(硬解析)。custom plan是指对于prepare语句,在执行execute的时候,把execute语句中的参数嵌套到语句之后生成的计划。custom plan会根据execute语句中具体的参数生成计划,这种方案的优点是每次都按照具体的参数生成优选计划,执行性能比较好;缺点是每次执行前都需要重新生成计划,存在大量的重复的优化器开销。
此参数只对prepare语句生效,一般用在prepare语句中参数化字段存在比较严重的数据倾斜的场景下。
默认值:auto
enable_hypo_index
参数说明:控制优化器执行EXPLAIN命令时是否考虑虚拟索引。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型
- on表示使用。
- off表示不使用。
默认值:off
enable_auto_explain
参数说明:控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询,只对当前连接的数据库主节点有效。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型,true表示开启,false表示关闭。
默认值:false。
auto_explain_level
参数说明:控制自动打印执行计划的日志等级。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:枚举型,LOG或NOTICE,LOG表示在日志中打印执行计划,NOTICE表示以提示知的形式打印出计划。
默认值:LOG。
auto_explain_log_min_duration
参数说明:控制自动打印执行计划的耗时阈值,整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:整型,0~2147483647,单位为毫秒。
- 设置为0,所有执行过的执行计划都会输出。
- 设置为3000,单次语句执行耗时超过3000毫秒后所有执行的执行计划会输出。
默认值:0
query_dop
参数说明: 用户自定义的查询并行度。该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:整型,1~64。打开固定SMP功能,系统会使用固定并行度。
在开启并行查询后,请保证系统CPU、内存、网络等资源充足,以达到最佳效果。
默认值:1
enable_startwith_debug
参数说明:该参数为start with/connect by用于debug的参数,打开参数可以显示start with特性所有涉及的尾列相关信息。
该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型,true表示开启,false表示关闭。
默认值:false。
enable_global_plancache
参数说明:设置是否对PBE查询的执行计划进行缓存共享,开启该功能可以节省高并发下数据库节点的内存使用。
在打开enable_global_plancache的情况下,为保证GPC生效,默认local_syscache_threshold不小于16MB。即如当前local_syscache_threshold小于16MB,则设置为16MB,如大于16MB,则不改变。
该参数属于POSTMASTER类型参数,请参考表1中对应设置方法进行设置。
取值范围:布尔型。
- on表示对PBE查询的执行计划进行缓存共享。
- off表示不共享。
默认值:off
gpc_clean_timeout
参数说明:开启enable_global_plancache的情况下,如果共享计划列表里的计划超过gpc_clean_timeout的时间没有被使用,则会被清理掉。本参数用于控制没有使用的共享计划的保留时间。
该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。
取值范围:整型,300~86400,单位为秒。
默认值:1800,即30min