メインコンテンツへスキップ
これらの設定は system.settings で確認でき、ソースコード から自動生成されています。

enable_join_fixed_hash_table_conversion

キーが値域の小さい単一の整数である場合に、join 用のハッシュテーブルをフラットな配列に変換できるようにします。

enable_join_key_only_hash_tables

結果に右側の行由来の値が決して含まれない join、すなわち LEFT ANTI および右側のカラムが選択されていない場合の LEFT SEMI では、右側の行への参照を持たず結合キーのみを格納する ハッシュテーブル を使用します。この種の ハッシュテーブル は cell が小さく、右側の block を保持せずに drop できます。

enable_join_runtime_filters

実行時に右側から収集した結合キーの集合で左側をフィルタリングします。

enable_join_runtime_filters_index_analysis

ビルド側で収集したランタイムフィルタを使い、JOINのプローブ側のグラニュールを除外します。enable_join_runtime_filtersを参照してください。 use_skip_indexes_on_data_read = 1の場合にのみ効果があります。 除外の対象となるのは、プローブ側の主キー列であるか、minmax、set、bloom_filterのいずれかのスキップ索引でカバーされている結合キーのみです。 ランタイムフィルタがキーの正確な値を保持している場合、それらの値を含むIN集合を除外述語に使用します。それ以外の場合はキーの最小値から最大値までの範囲を使用しますが、除外効果は低くなります。 並列レプリカ (enable_parallel_replicas = 1) でも動作します。各レプリカは、自身が構築したフィルタを使って、自身が読み取るグラニュールを除外します。このフィルタは部分的なものになる場合があります。RIGHT結合ではビルド側がレプリカ間で分割されるため、各レプリカのフィルタはその担当分しかカバーしません。それでも結果は正しく保たれます。結合のいずれか一方の側のみが分割され、一致する行のペアはそれぞれ必ずただ1つのレプリカ上で突き合わされ、各レプリカは結果の互いに重複しない部分を出力するためです。 分散クエリプラン (make_distributed_plan = 1) では、グラニュールの除外は行われません。この場合、この設定は効果を持ちません。クエリの結果は変わらず、JOINランタイムフィルタ自体もこの設定を無効にした場合とまったく同じように動作します。行われなくなるのはグラニュールの除外だけです。 プローブ側をFINALで読み取る場合も、グラニュールの除外は行われません (FINALを使用した読み取りでは除外が実装されておらず、optimizeLazyFinalはディスクリプタなしで読み取りを再構築します) 。処理待ちのデータ、ALTERミューテーション、またはパッチパートがあるテーブルでも同様です。これらの場合も、この設定は効果を持ちません。

enable_join_seal_gated_reading

ハッシュ JOIN のプローブ側の読み取りを、ビルド側のランタイムフィルタ (enable_join_runtime_filters を参照) が完了するまで待機させます (ゲート) 。フィルタが完了するまでプローブ側では一切読み取りが行われず、完了後はそのフィルタを使用して、通常の row-level のフィルタリングに加え、読み取りタスクの作成前に主キーに基づいてマーク範囲単位でデータを除外します。このゲートは、クエリパイプライン内の辺として表現されます。ゲートされた読み取りでは、同じランタイムフィルタに対する読み取り時の索引解析 (enable_join_runtime_filters_index_analysis を参照) は冗長となるためスキップされます。 実験的機能です。ローカルの読み取りは、シングルスレッドでの読み取りや順序どおりの読み取りも含めてゲートの対象となります。一方、FINAL を使用した読み取り、並列レプリカでの読み取り、または主キー範囲で分片された結合での読み取りは、ゲートなしの読み取りにフォールバックし、row-level のフィルタリングのみが適用されます。

enable_join_transitive_predicates

既存の JOIN 条件から、推移的な等値 JOIN 述語を推論します。 たとえば、A.x = B.x と B.x = C.x が与えられている場合、新たに A.x = C.x という述語 が追加され、JOIN 順序オプティマイザが (A JOIN C) のような直接的なプランを検討できるようになります。