parallel_replicas_* セッション設定

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

true の場合、IN のサブクエリは各フォロワー レプリカで実行されます。

並列レプリカでのmaterialized viewの使用を許可します

MergeTree テーブルに対する単純なビューで、並列レプリカがビューの内部クエリではなく外側のクエリを実行できるようにし、ノード間の並列化を向上させます。これは、すべての分岐が異なる MergeTree テーブルを読み取る UNION ALL ビューにも適用されます。

並列レプリカでクエリ実行を行う際に、リモートレプリカへの接続に使用するタイムアウトをミリ秒単位で指定します。タイムアウトした場合、該当するレプリカはクエリ実行に使用されません

これは内部設定であり、直接使用するものではなく、「並列レプリカ」モードの実装上の詳細を表します。この設定は、クエリ処理に参加する並列レプリカの数に合わせて、分散クエリのためにイニシエーターサーバーによって自動的に設定されます。

特定のテーブルに対して、レプリカ間で処理を分割するために使用できる任意の整数式です。 値には任意の整数式を指定できます。

主キーを使用した単純な式が推奨されます。

この設定を、単一の分片と複数のレプリカで構成されるクラスターで使用した場合、それらのレプリカは仮想分片に変換されます。 それ以外の場合は、SAMPLE キーと同様に動作し、各分片の複数のレプリカを使用します。

フィルタータイプ range が、カスタム範囲 [parallel_replicas_custom_key_range_lower, INT_MAX] に基づいて、レプリカ間で作業を均等に分割できるようにします。

parallel_replicas_custom_key_range_upper と組み合わせて使用すると、範囲 [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper] に対して、フィルターがレプリカ間で作業を均等に分割できるようになります。

注: この設定によってクエリ処理中に追加のデータがフィルタリングされることはありません。代わりに、並列処理のために範囲フィルターが範囲 [0, INT_MAX] を分割する境界点が変更されます。

フィルタータイプ range が、カスタム範囲 [0, parallel_replicas_custom_key_range_upper] に基づいて、レプリカ間で作業を均等に分割できるようにします。値が 0 の場合、上限は無効になり、カスタムキー式の最大値が設定されます。

parallel_replicas_custom_key_range_lower と組み合わせて使用すると、範囲 [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper] に対して、フィルターがレプリカ間で作業を均等に分割できるようになります。

注: この設定によってクエリ処理中に追加のデータがフィルターされることはありません。代わりに、並列処理のために範囲フィルターが範囲 [0, INT_MAX] を分割する位置が変更されます

並列レプリカが実行するよう選択するクエリの一部へのフィルタのプッシュダウンを許可します

table function エンジンを、対応する -Cluster の代替に置き換えます

true の場合、ClickHouse はレプリケートされていない MergeTree テーブルに対しても並列レプリカアルゴリズムを使用します

索引解析は replica-coordinator でのみ実行され、他のレプリカではスキップされます。parallel_replicas_local_pla が有効な場合にのみ適用されます

並列レプリカを使用する分散 INSERT SELECT でローカルパイプラインを使用します

ローカルレプリカ向けにローカルプランを構築します

パーツは、並列読み取りのためにレプリカ間へ分配されるセグメントに仮想的に分割されます。この設定は、それらのセグメントのサイズを制御します。何をしているのかを十分に理解している場合を除き、変更は推奨されません。値は [128; 16384] の範囲である必要があります。

クエリで使用するレプリカ数を、 (読み取ると推定される行数 / min_number_of_rows_per_replica) に制限します。なお、最大値は引き続き 'max_parallel_replicas' によって制限されます

並列レプリカでカスタムキーとともに使用するフィルターの種類。default - カスタムキーに対して剰余演算を使用します。range - カスタムキーの値の型で取り得るすべての値を使って、カスタムキーに範囲フィルターを適用します。

並列レプリカを使用するには、アナライザを有効にする必要があります。アナライザが無効な場合は、レプリカからの並列読み取りが有効になっていても、クエリ実行はローカル実行にフォールバックします。アナライザを有効にせずに並列レプリカを使用することはサポートされていません

クエリツリーベースの分析ではなくクエリプランを分析し、並列レプリカを使用するかどうか、およびどこで使用するかを決定します。その結果、SQLクエリではなくプランフラグメントがリモートレプリカに送信されます。実験的機能です。

true の場合、JOIN を並列レプリカアルゴリズムで実行でき、かつ JOIN の右側のすべてのストレージが *MergeTree であるときは、GLOBAL JOIN ではなくローカル JOIN が使用されます。

有効時 (デフォルト) には、並列読み取りに使用されるレプリカ群に常にローカルレプリカが含まれます。 無効時には、ローカルレプリカは優先されず、レプリカは負荷分散アルゴリズムのみに基づいて選択されます。 これにより、max_parallel_replicas = 1 を指定したクエリを別のホストに送ることができ、多数の短いクエリがクラスター全体に分散される場合のキャッシュ局所性を改善できます。

並列レプリカでプロジェクションの最適化を適用できます。parallel_replicas_local_plan が有効で、aggregation_in_order が無効な場合にのみ有効です。