Skip to main content
이러한 설정은 system.settings에서 확인할 수 있으며, 소스로부터 자동으로 생성됩니다.

parallel_replicas_allow_in_with_subquery

값이 true이면 IN용 서브쿼리가 모든 팔로워 레플리카에서 실행됩니다.

parallel_replicas_allow_materialized_views

병렬 레플리카에서 materialized view를 사용할 수 있도록 허용합니다

parallel_replicas_allow_merge_tables

병렬 레플리카로 Merge 테이블을 읽을 수 있도록 허용합니다. parallel_replicas_plan_based와 함께 사용할 때만 유효하며, 이때 Merge 테이블 읽기는 기반 MergeTree 테이블들에 대한 읽기의 union으로 확장되고, 이후 다른 union과 동일한 방식으로 분산됩니다. 기반 테이블 중 하나라도 이러한 방식으로 읽을 수 없는 경우(MergeTree가 아닌 테이블, FINAL 읽기)에는 해당 Merge 테이블이 단일 레플리카에서만 처리됩니다. 이 기능이 추가되기 이전처럼 모든 Merge 테이블을 단일 레플리카에서 읽으려면 false로 설정하십시오. 실험적 기능.

parallel_replicas_allow_view_over_mergetree

병렬 레플리카가 MergeTree 테이블 기반의 단순 뷰에서 뷰의 내부 쿼리 대신 바깥쪽 쿼리를 실행하도록 허용하여, 노드 간 병렬화를 향상합니다. 이 설정은 모든 분기가 서로 다른 MergeTree 테이블을 읽는 UNION ALL 뷰에도 적용됩니다.

parallel_replicas_connect_timeout_ms

병렬 레플리카를 사용해 쿼리를 실행할 때 원격 레플리카에 연결하는 데 적용되는 밀리초 단위 타임아웃입니다. 타임아웃이 초과되면 해당 레플리카는 쿼리 실행에 사용되지 않습니다.

parallel_replicas_count

이 설정은 내부용이므로 직접 사용해서는 안 되며, ‘병렬 레플리카’ 모드의 구현 세부 사항입니다. 분산 쿼리에서는 쿼리 처리에 참여하는 병렬 레플리카 수에 맞춰 initiator server가 이 설정을 자동으로 지정합니다.

parallel_replicas_custom_key

특정 테이블에 대해 레플리카 간 작업을 분할하는 데 사용할 수 있는 임의의 정수 표현식입니다. 값은 어떤 정수 표현식이든 될 수 있습니다. 프라이머리 키(primary key)를 사용하는 단순한 표현식을 권장합니다. 이 설정을 여러 레플리카를 가진 단일 세그먼트로 구성된 클러스터에서 사용하면, 해당 레플리카는 가상 세그먼트로 변환됩니다. 그렇지 않으면 SAMPLE 키와 동일하게 동작하며, 각 세그먼트의 여러 레플리카를 사용합니다. 표현식은 사용자에게 부여된 컬럼 수준 SELECT 권한을 기준으로 검사됩니다. SQL SECURITY DEFINER 또는 NONE이 적용된 뷰에서는 뷰의 컬럼에 적용되며, 뷰 본문은 이를 적용하지 않고 읽습니다.

parallel_replicas_custom_key_range_lower

사용자 지정 범위 [parallel_replicas_custom_key_range_lower, INT_MAX]를 기준으로 range 필터 유형이 레플리카 간 작업을 균등하게 분할할 수 있도록 합니다. parallel_replicas_custom_key_range_upper와 함께 사용하면 [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper] 범위에서 필터가 레플리카 전체에 작업을 균등하게 분할할 수 있습니다. 참고: 이 설정은 쿼리 처리 중 추가 데이터를 필터링하지 않습니다. 대신 병렬 처리를 위해 range 필터가 [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]에서 필터가 레플리카 전체에 작업을 균등하게 분할할 수 있습니다. 참고: 이 설정은 쿼리 처리 중 추가 데이터를 필터링하지 않습니다. 대신 병렬 처리를 위해 range 필터가 범위 [0, INT_MAX]를 분할하는 지점을 변경합니다.

parallel_replicas_filter_pushdown

병렬 레플리카가 실행하도록 선택한 쿼리 부분에 필터를 푸시다운할 수 있도록 허용합니다

parallel_replicas_for_cluster_engines

테이블 함수 엔진을 해당 -Cluster 버전으로 대체합니다

parallel_replicas_for_non_replicated_merge_tree

true이면 ClickHouse는 복제되지 않은 MergeTree 테이블에도 병렬 레플리카 알고리즘을 사용합니다

parallel_replicas_index_analysis_only_on_coordinator

인덱스 분석은 레플리카 코디네이터에서만 수행되며 다른 레플리카에서는 생략됩니다. parallel_replicas_local_plan이 활성화된 경우에만 적용됩니다.

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 - 사용자 지정 키에 modulo 연산을 사용합니다. range - 사용자 지정 키의 값 유형에서 가능한 모든 값을 사용해 사용자 지정 키에 범위 필터를 적용합니다.

parallel_replicas_plan_based

쿼리 트리 기반 분석 대신 쿼리 계획을 분석하여 병렬 레플리카를 사용할지와 사용할 위치를 결정합니다. 그 결과 SQL 쿼리 대신 계획 프래그먼트가 원격 레플리카로 전송됩니다. 실험적 기능입니다.

parallel_replicas_prefer_local_join

true이고 JOIN을 병렬 레플리카 알고리즘으로 실행할 수 있으며, 그렇지 않으면 임시 테이블로 구체화되었을 JOIN 부분의 모든 스토리지를 각 레플리카가 자체적으로 읽을 수 있는 경우, GLOBAL JOIN 대신 로컬 JOIN을 사용합니다. 여기서 해당 부분은 오른쪽 부분이지만, RIGHT JOIN에서는 왼쪽 부분이며 이때는 모든 스토리지가 단순히 *MergeTree이기만 하면 되는 것이 아니라 병렬 레플리카에 적합해야 합니다. 중첩된 GLOBAL JOIN의 구체화되는 쪽에 있는 스토리지나 GLOBAL IN 아래에 있는 스토리지는 여기에 포함되지 않으며, initiator가 이를 직접 구체화하기 때문입니다.

parallel_replicas_prefer_local_replica

활성화된 경우(기본값) 로컬 레플리카는 병렬 읽기에 사용되는 레플리카 집합에 항상 포함됩니다. 비활성화된 경우 로컬 레플리카에는 우선권이 부여되지 않으며, 레플리카는 부하 분산 알고리즘에 따라서만 선택됩니다. 이렇게 하면 max_parallel_replicas = 1인 쿼리를 다른 호스트로 보낼 수 있으므로, 많은 짧은 쿼리가 클러스터 전체에 분산될 때 캐시 지역성을 개선할 수 있습니다.

parallel_replicas_support_projection

프로젝션 최적화는 병렬 레플리카에서 적용할 수 있습니다. parallel_replicas_local_plan이 활성화되어 있고 aggregation_in_order가 비활성화된 경우에만 적용됩니다.
마지막 수정일 2026년 9월 26일