query_plan_* セッション設定

これらの設定は system.settings で確認でき、ソース から自動生成されています。 集約における 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 - 有効

両方のテーブルで、結合キーに PRIMARY KEY のプレフィックスが含まれている場合は、JOIN に対して分片化を適用します。hash、parallel_hash、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 の場合、制限はありません。 クエリプランに適用する最適化の総数を制限します。設定 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 はこの最適化が無効であることを意味します。 クエリプランの最適化時に試行する 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 付きの読み取りを最適化します。 遅延マテリアライゼーションの最適化でクエリプランを使用します。 サポートされているストレージで、フィルタをPREWHERE式にプッシュダウンできるようにします 実行計画内で LIMIT をより下流へ移動するクエリプランレベルの最適化を切り替えます。 この設定は、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 - 有効

フィルターを式に分割する、クエリプランレベルの最適化を切り替えます。 設定 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 - 有効