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

parallel_replicas_allow_in_with_subquery

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

parallel_replicas_allow_materialized_views

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

parallel_replicas_allow_view_over_mergetree

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

parallel_replicas_connect_timeout_ms

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

parallel_replicas_count

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

parallel_replicas_custom_key

特定のテーブルに対して、レプリカ間で処理を分割するために使用できる任意の整数式です。 値には任意の整数式を指定できます。 主キーを使用した単純な式が推奨されます。 この設定を、単一の分片と複数のレプリカで構成されるクラスターで使用した場合、それらのレプリカは仮想分片に変換されます。 それ以外の場合は、SAMPLE キーと同様に動作し、各分片の複数のレプリカを使用します。

parallel_replicas_custom_key_range_lower

フィルタータイプ 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] を分割する境界点が変更されます。

parallel_replicas_custom_key_range_upper

フィルタータイプ 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] を分割する位置が変更されます

parallel_replicas_filter_pushdown

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

parallel_replicas_for_cluster_engines

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

parallel_replicas_for_non_replicated_merge_tree

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

parallel_replicas_index_analysis_only_on_coordinator

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

parallel_replicas_insert_select_local_pipeline

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

parallel_replicas_local_plan

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

parallel_replicas_mark_segment_size

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

parallel_replicas_min_number_of_rows_per_replica

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

parallel_replicas_mode

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

parallel_replicas_only_with_analyzer

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

parallel_replicas_plan_based

並列レプリカのローカル/リモート境界を、プラン変換として表現します。プランナーはまず通常のローカルプランを構築し、次に読み取りステップの上に分割ステップを挿入します。その後、分割ステップより下のプラン部分を、ローカル読み取りとリモート読み取りの UNION に置き換えます。これにより、その部分はレプリカ上で実行され、残りはコーディネーター上で実行されます。実験的機能であり、parallel_replicas_local_plan より優先されます。

parallel_replicas_prefer_local_join

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

parallel_replicas_prefer_local_replica

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

parallel_replicas_support_projection

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