query_plan_* 会话设置

这些设置可在 system.settings 中查看，且由 源代码 自动生成。 控制是否启用按序聚合的查询计划级别优化。 仅当设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

如果 JOIN 之后的过滤器对未匹配行或已匹配行的求值结果始终为 false，则允许将 ANY JOIN 转换为 SEMI 或 ANTI JOIN 如果输出列仅关联左表，则允许将 JOIN 转换为使用 IN 的子查询。对于非 ANY JOIN (例如默认的 ALL JOIN) ，这可能会导致结果错误。 如果 JOIN 之后的过滤器总是会过滤掉默认值，则允许将 OUTER JOIN 转换为 INNER JOIN 允许在查询计划中仅使用倒排文本索引进行全文检索筛选。 在 EXPLAIN PLAN 中显示内部别名 (如 __table1) ，而非显示原始查询中指定的别名。 在计算窗口函数后启用多线程，以支持并行流处理 控制是否在查询计划层启用查询优化。 可能的值：

• 0 - 禁用查询计划层的所有优化
• 1 - 启用查询计划层的优化 (但仍可通过各自的设置禁用单项优化)

切换一项查询计划级别的优化，该优化会将表达式移到排序步骤之后执行。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

用于切换一项查询计划级别的优化，该优化会将过滤器下推到执行计划的更底层。 仅当设置 query_plan_enable_optimizations 为 1 时才会生效。 可能的值：

• 0 - 禁用
• 1 - 启用

如果两个表的连接键都包含 PRIMARY KEY 的前缀，则对 JOIN 启用分片。支持哈希、parallel_hash、full_sorting_merge 和 parallel_full_sorting_merge 算法。通常不会加速查询，但可能会降低内存消耗。 确定在查询计划中，JOIN 的哪一侧应作为 build 表 (也称 inner，即在 hash join 中插入哈希表的一侧) 。此设置仅支持带有 JOIN ON 子句的 ALL join strictness。可能的值包括：

• ‘auto’：由 planner 决定使用哪个表作为 build 表。
• ‘false’：从不交换表 (右表为 build 表) 。
• ‘true’：始终交换表 (左表为 build 表) 。

用于切换一项查询计划级别的优化，该优化会在执行计划中将 ARRAY JOIN 上提。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

用于切换一项查询计划级别的优化：将查询计划中更大的子树提升到 union 中，以便进一步优化。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

控制可在 JOIN 中使用查询计划进行惰性索引优化时允许的最大 LIMIT 值。若为 0，则不受限制。 控制可对惰性物化优化使用查询计划的最大 LIMIT 值。若为 0，则不受限制。 控制允许使用 minmax 跳过索引和动态阈值筛选来评估 TopK 优化查询计划的最大 LIMIT 值。如果为 0，则不设限制。 限制应用到查询计划上的优化总次数，参见设置 query_plan_enable_optimizations。 可用于避免复杂查询的优化耗时过长。 在 EXPLAIN PLAN 查询中，达到此限制后将停止继续应用优化，并按原样返回查询计划。 对于常规查询执行，如果实际优化次数超过此设置，则会抛出异常。 在判断两个 IN 子句集合是否相等时，投影匹配器会计算并比较其内容哈希；此设置定义了可执行该操作的最大行数。超过此值的集合会被视为不匹配，并跳过该投影。值为 0 时将完全禁用内容哈希比较：对于包含 IN 子句集合的节点，投影匹配将永远不会成功。 该设置由聚合投影匹配器使用 (以及未来任何需要比较 IN 子句集合的投影匹配器) 。计算内容哈希的复杂度相对于集合中元素数量为 O(N log N)；当查询或投影中出现大量 IN 子句时，此设置可限制规划阶段的开销。 EXPLAIN PLAN 中步骤描述的最大长度。 允许在 JOIN 重排序优化过程中将表达式合并到 JOIN 步骤中。 用于启用或禁用一项会合并连续过滤器的查询计划级别的优化。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

允许将过滤条件合并到 JOIN 条件中，并将 CROSS JOIN 转换为 INNER JOIN。 允许在查询计划中合并过滤器。 控制启用 JOIN 中惰性索引优化时左侧所需的最小载荷列数。0 表示禁用此优化。 允许直接利用文本索引倒排列表的基数执行 SELECT count() ... WHERE <text search predicate>，无需具体化匹配的行。 仅在启用 query_plan_direct_read_from_text_index 时生效。 指定在优化查询计划时要尝试哪些 JOIN 顺序算法。可用算法如下：

• ‘greedy’ - 基础贪心算法 - 速度快，但不一定能生成最佳 JOIN 顺序
• ‘dpsize’ - 实现 DPsize 算法，目前仅支持 INNER JOIN - 会考虑所有可能的 JOIN 顺序并找出最优方案，但对于包含大量表和 JOIN 谓词的查询可能较慢。
• ‘dpsub’ - 实现 DPsub 算法，同时支持 INNER JOIN 和非 INNER JOIN - 会考虑所有可能的 JOIN 顺序并找出最优方案，但对于包含大量表和 JOIN 谓词的查询可能较慢。
• ‘dphyp’ - 实现 DPhyp (通过超图分区进行动态规划) 算法，目前仅支持 INNER JOIN - 探索与 dpsize 相同的搜索空间，但只枚举连通子图对，因此在稀疏 JOIN 图上生成的中间 JOIN 更少，代价是不考虑笛卡尔积 可以将多个算法指定为逗号分隔的列表，例如 dphyp,greedy。系统会按顺序尝试这些算法；如果某个算法无法处理该查询 (例如由于存在 OUTER JOIN 或不连通分量) ，则会回退到下一个算法。

优化同一子查询中 JOIN 的顺序。目前仅支持极少数情况。 值表示可优化的最大表数量。 JOIN 顺序优化器在放弃当前算法并回退到 query_plan_optimize_join_order_algorithm 中的下一个算法之前，可枚举的部分计划最大数量。 该设置会以确定性的方式限制优化时间 (与实际时钟时间无关) ，适用于团状或星状等稠密 JOIN 图，因为这类场景中的搜索空间会呈指数级增长。 设置为 0 可禁用此限制。对默认的 query_plan_optimize_join_order_limit 没有影响，因为在默认情况下，搜索规模始终远低于此上限。 当该值非 0 时，JOIN 顺序优化器会使用随机生成的基数和 NDV，而不是真实的统计信息。 当设置为 1 时，会生成一个随机种子；当设置为大于 1 的值时，则直接使用该值作为种子。 此设置用于测试，以发现由不同 JOIN 顺序引起的错误。 通过构建主键集合并将其用于索引分析，优化从 ReplacingMergeTree 使用 FINAL 读取时的性能。 使用查询计划进行惰性物化优化。 对从对象存储 (包括 Iceberg 表) 读取 Parquet 文件时使用惰性物化优化：对于 ORDER BY ... LIMIT n 查询，仅对经 LIMIT 保留的 n 行读取排序和筛选不需要的列。仅当启用 query_plan_optimize_lazy_materialization 时生效。 允许将过滤器下推到受支持存储的 PREWHERE 表达式 控制是否启用一项查询计划级别的优化：将 LIMIT 下推到执行计划的更低层级。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

控制 ORDER BY ... LIMIT BY 查询的一项查询计划级别的优化。当 LIMIT BY 的列是 ORDER BY 子句的前缀时，每个并行排序流都会在合并成一个流之前先执行 LIMIT BY，从而减少最终合并以及后续管道阶段需要处理的行数。对于 LIMIT BY 会丢弃大量行的查询，这项优化可提升速度。 仅当设置 query_plan_enable_optimizations 为 1 时，此设置才会生效。 可能的值：

• 0 - 禁用
• 1 - 启用

用于开启或关闭按顺序读取的查询计划级别优化。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可选值：

• 0 - 禁用
• 1 - 启用

在 JOIN 操作中保持按顺序从左表读取，以便后续步骤加以利用。 允许 query_plan_read_in_order_through_join 也适用于通过 max_bytes_before_external_join 或 max_bytes_ratio_before_external_join 配置了自动落盘阈值的 hash join。 此类连接只有在从不落盘时，才能保证保留左表的顺序，因为落盘会按哈希将行分散到各个桶中。因此，该优化生效时，连接会保留在内存中，且不再触发落盘阈值：右侧表将改由内存跟踪器限制，如同未配置自动落盘一样。 设置为 0 可保留保守行为，即绝不让按顺序读取穿透可能落盘的连接。依赖落盘以满足内存限制，且原本会符合该优化条件的查询，将继续按原有方式运行。 独立的通过 JOIN 执行 ORDER BY ... LIMIT 的优化会将 Sort 和 Limit 下推到连接的保留侧。它从不依赖连接保留任何顺序，因此无论此设置如何，对于支持落盘的连接都仍然可用。不过，当可以按顺序读取时，它会为按顺序读取让路——因此，启用此设置后，若支持落盘连接的保留侧能够按请求的顺序流式传输行，其上的 ORDER BY ... LIMIT 将采用按顺序读取计划，而非下推的 Sort 和 Limit。该切换仍遵循原有条件，尤其是必须将 query_plan_join_swap_table 显式设置为 false：在默认的 auto 下，后续优化可能会交换连接两侧，使按顺序读取计划失效，因此不会采用该切换，此类查询将继续使用下推的 Sort 和 Limit。 用于控制是否启用一项查询计划级别的优化，该优化会移除冗余的 DISTINCT 步骤。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

控制一项查询计划级别的优化，用于移除冗余的排序步骤，例如子查询中的排序步骤。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

用于控制一项查询计划级别的优化开关，该优化会尝试从查询计划步骤中移除未使用的列 (包括输入列和输出列) 。 仅当设置 query_plan_enable_optimizations 为 1 时才会生效。 可能的值：

• 0 - 禁用
• 1 - 启用

别名: optimize_read_in_window_order 切换一项查询计划级别的优化，在对窗口函数进行排序时复用存储排序。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

对于 ON 条件可折叠为常量 false 的 JOIN，将无法产生行的每个输入侧替换为空源 (INNER/CROSS/SEMI 为两侧，LEFT/RIGHT 为非保留侧) ，从而避免读取无法产生结果的一侧。适用于 analyzer (enable_analyzer = 1) 和非分布式查询计划。 用于切换一种将过滤器拆分为表达式的查询计划级别的优化。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

允许为查询计划中基于倒排文本索引构建的过滤器添加 hint (附加谓词) 。 用于切换一种查询计划级别的优化：当排序键仅引用连接保留侧 (LEFT/RIGHT) 的列时，将 ORDER BY ... LIMIT n 下推到连接之前。该优化会限制保留侧输入在连接前需要生成的行数。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用

控制是否启用一项会尝试使用向量相似度索引的查询计划级别的优化。 仅在设置 query_plan_enable_optimizations 为 1 时生效。 可能的值：

• 0 - 禁用
• 1 - 启用