content/zh/docs/Developerguide/优化器方法配置.md · openGauss/docs

# 优化器方法配置<a name="ZH-CN_TOPIC_0289900000"></a>

这些配置参数提供了影响查询优化器选择查询规划的原始方法。如果优化器为特定的查询选择的缺省规划并不是最优的，可以通过使用这些配置参数强制优化器选择一个不同的规划来临时解决这个问题。更好的方法包括调节优化器开销常量、手动运行ANALYZE、增加配置参数default\_statistics\_target的值、增加使用ALTER TABLE SET STATISTICS为指定列增加收集的统计信息。

## enable\_bitmapscan<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s6ff0e1cd09c948469a5e8663cafc209f"></a>

**参数说明**：控制优化器对位图扫描规划类型的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## force\_bitmapand<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_section390014483481"></a>

**参数说明**：控制优化器强制使用bitmapand规划类型的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：off

## enable\_hashagg<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s6589532cef104139a10a9b585c97c56b"></a>

**参数说明**：控制优化器对Hash聚集规划类型的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_hashjoin<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s566de83fd081416099e1453b10816d77"></a>

**参数说明**：控制优化器对Hash连接规划类型的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_indexscan<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s6f45bb20aded4ed5814fb37ff3849afc"></a>

**参数说明**：控制优化器对索引扫描规划类型的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_indexonlyscan<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_se9bdf3f7db06400482c7c978e00fcc58"></a>

**参数说明**：控制优化器对仅索引扫描规划类型的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_material<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s9c4bdbba1ad645b497b7d5a2e4cbfd5a"></a>

**参数说明**：控制优化器对实体化的使用。消除整个实体化是不可能的，但是可以关闭这个变量以防止优化器插入实体节点。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_mergejoin<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_sfc257a8da5f94bbfbe8396598e5fd0e4"></a>

**参数说明**：控制优化器对融合连接规划类型的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：off

## enable\_nestloop<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s5f30625b2fa94498b3b44df41c96970a"></a>

**参数说明**：控制优化器对内表全表扫描嵌套循环连接规划类型的使用。完全消除嵌套循环连接是不可能的，但是关闭这个变量就会让优化器在存在其他方法的时候优先选择其他方法。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：off

## enable\_index\_nestloop<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_section1584803291014"></a>

**参数说明**：控制优化器对内表参数化索引扫描嵌套循环连接规划类型的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_seqscan<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_sd4833f4c14424278a6d0a81ae1195666"></a>

**参数说明**：控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的，但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_sort<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_sb7f3e95793bc4b4d98518a77ffba4e4a"></a>

**参数说明**：控制优化器使用的排序步骤。完全消除明确的排序是不可能的，但是关闭这个变量可以让优化器在存在其他方法的时候优先选择其他方法。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_tidscan<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s87c617fc3c47455195a4815d45510482"></a>

**参数说明**：控制优化器对TID扫描规划类型的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_kill\_query<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s2deb52bc33e24b0d9e626eb6b79f80dc"></a>

**参数说明**：CASCADE模式删除用户时，会删除此用户拥有的所有对象。此参数标识是否允许在删除用户的时候，取消锁定此用户所属对象的query。

该参数属于SUSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示允许取消锁定。
-   off表示不允许取消锁定。

**默认值**：off

## enforce\_a\_behavior<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_sf2c1a90cdefd484ea8d0ac530476ade1"></a>

**参数说明：**控制正则表达式的规则匹配模式。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围：**布尔型

-   on表示正则表达式采用A格式的匹配规则。
-   off表示正则表达式采用POSIX格式的匹配规则。

**默认值：**on

## max\_recursive\_times<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_section333410396346"></a>

**参数说明**：控制with recursive的最大迭代次数。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：整型，0～INT\_MAX。

**默认值**：200

## enable\_vector\_engine<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s0d040b72fd304d8ab8f063ffd98226a7"></a>

**参数说明**：控制优化器对向量化执行引擎的使用。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：on

## enable\_change\_hjcost<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_s2c3550150fa4494e82080e7c96d93732"></a>

**参数说明**：控制优化器在Hash Join代价估算路径选择时，是否使用将内表运行时代价排除在Hash Join节点运行时代价外的估算方式。如果使用，则有利于选择条数少，但运行代价大的表做内表。

该参数属于SUSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示使用。
-   off表示不使用。

**默认值**：off

## enable\_absolute\_tablespace<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_section2170938217248"></a>

**参数说明：**控制表空间是否可以使用绝对路径。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围：**布尔型

-   on表示可以使用绝对路径。
-   off表示不可以使用绝对路径。

**默认值：**on

## enable\_valuepartition\_pruning<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_zh-cn_topic_0059778346_section25701680101350"></a>

**参数说明：**是否对DFS分区表进行静态/动态优化。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围：**布尔型

-   on表示对DFS分区表进行静态/动态优化。
-   off表示不对DFS分区表进行静态/动态优化。

**默认值：**on

## expected\_computing\_nodegroup<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_section746841514523"></a>

**参数说明**：标识选定的计算Node Group模式或目标计算Node Group。Node Group目前为内部用机制，用户无需设置。

共4种计算Node Group模式，用于关联操作和聚集操作时选定计算Node Group。在每一种模式中，优化器有针对性地选定几个候选计算Node Group，然后根据代价，从中为当前算子挑选最佳计算Node Group。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：字符串

-   optimal：候选计算Node Group列表包含算子操作对象所在的Node Group和由当前用户具有COMPUTE权限的所有Node Group包含的数据库节点构成的Node Group
-   query：候选计算Node Group列表包含算子操作对象所在的Node Group和由当前查询涉及的所有基表所在Node Group包含的数据库节点构成的Node Group
-   Node Group名（enable\_nodegroup\_debug被设置为off）：候选计算Node Group列表包含算子操作对象所在的Node Group和该指定的Node Group
-   Node Group名（enable\_nodegroup\_debug被设置为on）：候选计算Node Group为指定的Node Group

**默认值**：query

## enable\_nodegroup\_debug<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_section1426622145210"></a>

**参数说明**：控制优化器在多Node Group环境下，是否使用强制弹性计算。Node Group目前为内部用机制，用户无需设置。

该参数只在expected\_computing\_nodegroup被设置为具体Node Group时生效。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示强制将计算弹性到expected\_computing\_nodegroup所指定的Node Group进行计算。
-   off表示不强制使用某个Node Group进行计算。

**默认值**：off

## qrw\_inlist2join\_optmode<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_section207996212178"></a>

**参数说明**：控制是否使用inlist-to-join查询重写。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：字符串

-   disable：关闭inlist2join查询重写。
-   cost\_base：基于代价的inlist2join查询重写。
-   rule\_base：基于规则的inlist2join查询重写，即强制使用inlist2join查询重写。
-   任意正整数：inlist2join查询重写阈值，即list内元素个数大于该阈值，进行inlist2join查询重写。

**默认值**：cost\_base

## skew\_option<a name="zh-cn_topic_0283136675_zh-cn_topic_0237124716_section1211182712176"></a>

**参数说明**：控制是否使用优化策略。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：字符串

-   off：关闭策略。
-   normal：采用激进策略。对于不确定是否出现倾斜的场景，认为存在倾斜，并进行相应优化。
-   lazy：采用保守策略。对于不确定是否出现倾斜场景，认为不存在倾斜，不进行优化。

**默认值**：normal

## default\_limit\_rows<a name="section5328711171611"></a>

**参数说明**：设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数，为负数时代表使用百分比的形式设置默认的估算值，负数转换为默认百分比，即-5代表5%。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：浮点型，-100\~DBL\_MAX。

**默认值**：-10

## check\_implicit\_conversions<a name="zh-cn_topic_0283137548_zh-cn_topic_0237124743_section214364810316"></a>

**参数说明**：控制是否对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。

该参数属于USERSET类型参数，请参考[表1](重设参数.md#zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。

**取值范围**：布尔型

-   on表示对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。
-   off表示不进行相关检查。

**默认值**：off

openGauss/docs

简介

发行版

贡献者

近期动态

openGauss/docs .gitee-modal { width: 500px !important; }

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

openGauss/docs