query_plan_* セッション設定

これらの設定は system.settings で確認でき、ソース から自動生成されています。

最終集約の出力に LIMIT n 付きの ORDER BY を適用し、プランによってバケットごとの選択が正確であることを証明できる場合に、集約の最終変換時に各二段階バケットの上位 n グループのみをその順序でマテリアライズするクエリプランレベルの最適化を切り替えます。結果は正確です。自身のバケットで上位 n に入らないグループには、グローバルでは少なくとも n 個のグループが先行するため、グローバルの top n に入ることはありません。 設定 query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効化
• 1 - 有効化

集約における in-order のクエリプランレベル最適化を切り替えます。 設定 query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効

JOIN の後のフィルタが、不一致の行または一致した行に対して常に false と評価される場合に、ANY JOIN を SEMI JOIN または 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 - 有効

ARRAY JOINされた要素カラムに対するフィルターをARRAY JOINステップに統合する、クエリプランレベルの最適化を切り替えます。展開前に要素レベルで配列をフィルタリングするため、フィルターで除外された要素が展開または複製されることはありません。 設定query_plan_enable_optimizationsが1の場合にのみ有効です。

両方のテーブルで、結合キーに PRIMARY KEY のプレフィックスが含まれている場合は、JOIN に対して分片化を適用します。hash、parallel_hash、full_sorting_merge、parallel_full_sorting_merge アルゴリズムでサポートされています。通常、クエリの高速化にはつながりませんが、メモリ消費量を抑えられる場合があります。

クエリプランにおいて、結合のどちら側をビルドテーブル (inner とも呼ばれ、ハッシュ結合ではハッシュテーブルに挿入される側) にするかを決定します。この設定は、JOIN ON 句を使用する ALL join strictness でのみサポートされています。設定可能な値は次のとおりです。

• 'auto': どのテーブルをビルドテーブルとして使用するかをプランナーが決定します。
• 'false': テーブルを入れ替えません (右テーブルがビルドテーブルになります) 。
• 'true': 常にテーブルを入れ替えます (左テーブルがビルドテーブルになります) 。

実行計画内で ARRAY JOIN を上位に移動する、クエリプランレベルの最適化を切り替えます。 この設定は、query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効

クエリプラン内のより大きな部分木をユニオンへ移動し、追加の最適化を可能にするクエリプランレベルの最適化をトグルします。 この設定は query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効

JOIN の遅延索引最適化でクエリプランを使用できる上限値を制御します。0 の場合、制限はありません。

遅延マテリアライゼーションの最適化にクエリプランを使用できる最大制限値を制御します。0 の場合、制限はありません。

minmax スキップ索引と動的しきい値フィルタリングを使用した TopK 最適化のクエリプラン評価を可能にする最大制限値を制御します。0 の場合、制限はありません。

この設定は、enable_group_by_top_k_optimization の動作も制御します。

クエリプランに適用する最適化の総数を制限します。設定 query_plan_enable_optimizations を参照してください。 複雑なクエリで最適化に時間がかかりすぎるのを防ぐのに役立ちます。 EXPLAIN PLAN クエリでは、この上限に達すると最適化の適用を停止し、その時点のプランをそのまま返します。 通常のクエリ実行では、実際の最適化回数がこの設定値を超えると、例外が発生します。

projection matcher が 2 つの Set が等しいかどうかを判定する際に、内容ハッシュを計算して比較する IN 句の Set の最大行数です。これを超える Set は不一致として扱われ、projection はスキップされます。0 を指定すると内容ハッシュ比較は完全に無効化されます。この場合、IN 句の Set を含む node では projection match は決して成功しません。

aggregate projection matcher (および、IN 句の Set を比較する必要がある将来の projection matcher) で使用されます。内容ハッシュの計算量は、Set の elements 数に対して O(N log N) です。この設定は、クエリまたは projection に多数の IN 句が現れる場合に、プランニング時に発生するコストを抑えるためのものです。

EXPLAIN PLAN におけるステップの説明の最大長。

JOIN 順序の最適化時に、式を JOIN ステップにマージできるようにします。

連続するフィルタをマージするクエリプランレベルの最適化を切り替えます。 この設定は、query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効

フィルターを JOIN 条件にマージし、CROSS JOIN を INNER に変換できるようにします。

クエリプラン内のフィルタをマージできるようにします。

JOIN で遅延索引最適化を有効にするために必要な、左側の payload カラムの最小数を制御します。0 はこの最適化が無効であることを意味します。

一致する行をマテリアライズすることなく、テキスト索引のポスティングリストのカーディナリティから直接 SELECT count() ... WHERE <text search predicate> に応答できるようにします。 query_plan_direct_read_from_text_index が有効な場合にのみ有効です。

クエリプランの最適化時に試行する JOIN 順序アルゴリズムを指定します。利用可能なアルゴリズムは次のとおりです。

• 'greedy' - 基本的な貪欲アルゴリズムです。高速に動作しますが、最適な JOIN 順序にならない場合があります
• 'dpsize' - 現時点では INNER JOIN のみに対応する DPsize アルゴリズムを実装します。考えられるすべての JOIN 順序を検討して最適なものを見つけますが、テーブル数や JOIN 条件が多いクエリでは遅くなることがあります。
• 'dpsub' - INNER JOIN と INNER JOIN 以外の JOIN の両方に対応する DPsub アルゴリズムを実装します。考えられるすべての JOIN 順序を検討して最適なものを見つけますが、テーブル数や JOIN 条件が多いクエリでは遅くなることがあります。
• 'dphyp' - 現時点では INNER JOIN のみに対応する DPhyp (ハイパーグラフ分割による動的計画法) アルゴリズムを実装します。dpsize と同じ探索空間を調べますが、連結された部分グラフのペアだけを列挙するため、クロス積を考慮しない代わりに、スパースな JOIN グラフでは中間 JOIN の数を減らせます 複数のアルゴリズムは、たとえば dphyp,greedy のようにカンマ区切りのリストで指定できます。指定した順に試行され、あるアルゴリズムでクエリを処理できない場合 (たとえば OUTER JOIN や非連結なコンポーネントがある場合) は、フォールバックとして次のアルゴリズムが使用されます。

同じサブクエリ内の JOIN 順序を最適化します。現在のところ、ごく限られたケースでのみサポートされています。 値は、最適化対象とするテーブルの最大数です。

query_plan_optimize_join_order_algorithm で、JOIN 順序オプティマイザが打ち切って次のアルゴリズムにフォールバックするまでに列挙できる部分プランの最大数です。 これにより、クリークやスターのように探索空間が指数関数的に増大する密な JOIN グラフにおいて、optimization 時間を決定論的に制限できます (実時間には依存しません) 。 制限を無効にするには 0 に設定します。既定の query_plan_optimize_join_order_limit では探索が常にこの上限を十分下回るため、影響はありません。

0 以外の値を設定すると、JOIN 順序オプティマイザは実際の統計の代わりに、ランダムに生成されたカーディナリティと NDV を使用します。 1 に設定するとランダムシードが生成され、1 より大きい値に設定すると、その値がシードとして直接使用されます。 これは、異なる JOIN 順序によって発生するエラーを見つけるためのテストを目的としています。

主キーのセットを構築し、それを索引解析に使用することで、ReplacingMergeTree に対する FINAL 付きの読み取りを最適化します。

遅延マテリアライゼーションの最適化でクエリプランを使用します。

file テーブル関数および File テーブルエンジンを使用してローカル Parquet ファイルを読み取る際に、遅延マテリアライゼーションの最適化を使用します。ORDER BY ... LIMIT n クエリでは、ソートとフィルタリングに不要なカラムは、LIMIT 後に残る n 行に対してのみ読み取られます。query_plan_optimize_lazy_materialization が有効な場合にのみ有効です。

オブジェクトストレージから Parquet ファイル (Iceberg テーブルを含む) を読み取る際に、遅延マテリアライゼーションの最適化を使用します。ORDER BY ... LIMIT n クエリでは、ソートやフィルタリングに不要なカラムは、LIMIT の結果として残った n 行についてのみ読み取られます。query_plan_optimize_lazy_materialization が有効な場合にのみ有効です。

サポートされているストレージで、フィルタをPREWHERE式にプッシュダウンできるようにします

実行計画内で LIMIT をより下流へ移動するクエリプランレベルの最適化を切り替えます。 この設定は、query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効

データ量を削減する関数 (length、lengthUTF8、empty、notEmpty) を実行計画内の Sorting および Filter ステップの下へ移動する、クエリプランレベルの最適化を切り替えます。固定サイズの結果で wide String / FixedString の引数を置き換えるため、これらのステップで引数を保持する必要がなくなります。 この書き換えは、プッシュダウン先のステップより上で引数カラムが不要な場合にのみ適用されます。

設定 query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効化
• 1 - 有効化

ORDER BY ... LIMIT BY クエリに対する クエリプランレベルの最適化 を切り替えます。LIMIT BY のカラムが ORDER BY 句のプレフィックスである場合、各並列ソート済みストリームは、ストリームが 1 つにマージされる前に LIMIT BY を適用します。これにより、最終マージおよび後続のパイプライン段階で処理される行数が減少します。LIMIT BY によって大量の行が破棄されるクエリを高速化します。

この設定は、query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効

read in-order 最適化のクエリプランレベルでの 最適化 を切り替えます。 設定 query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効

JOIN演算において左テーブルから順序どおりに読み取りを継続し、その後のステップで利用できるようにします。

冗長な 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 では保持されない側) を空のソースに置き換えることで、結果に寄与しない側を読み取りません。アナライザ (enable_analyzer = 1) および非分散プランに適用されます。

フィルターを式に分割する、クエリプランレベルの最適化を切り替えます。 設定 query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効

クエリプランで、転置テキスト索引から構築されるフィルタリングに対するヒント (追加の述語) を追加できるようにします。

ソートキーが join で保持される側 (LEFT/RIGHT) のカラムのみを参照している場合に、ORDER BY ... LIMIT n を join をまたいでプッシュダウンするクエリプランレベルの最適化を切り替えます。これにより、join 前に保持側の入力で生成される行数が制限されます。 設定 query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効

ベクトル類似度索引の使用を試みるクエリプランレベルの最適化を切り替えます。 この設定は、query_plan_enable_optimizations が 1 の場合にのみ有効です。

設定可能な値:

• 0 - 無効
• 1 - 有効