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

distributed_plan_default_reader_bucket_count

분산 쿼리에서 병렬 읽기에 사용되는 기본 작업 수입니다. 작업은 레플리카 간에 분산됩니다. 규칙 기반 분산 플래너에서 사용됩니다. 비용 기반 최적화기는 추정 비용에 따라 읽기 팬아웃을 선택하며 이 설정을 사용하지 않습니다.

distributed_plan_default_shuffle_join_bucket_count

분산 shuffle-hash join의 기본 버킷 개수입니다. 규칙 기반 분산 플래너에서 사용됩니다. 비용 기반 최적화기는 추정 비용에 따라 팬아웃을 선택하므로 이 설정을 사용하지 않습니다.

distributed_plan_execute_locally

분산 쿼리 계획의 모든 작업을 로컬에서 실행합니다. 테스트와 디버깅에 유용합니다.

distributed_plan_fallback_to_local_execution

쿼리 계획에 분산 실행을 지원하지 않는 단계가 포함되어 있으면 예외를 발생시키는 대신 그 이유를 로그에 기록하고 initiator에서 쿼리를 실행합니다. 예외를 발생시키려면 이 설정을 비활성화하십시오. make_distributed_plan(비공개 프리뷰)이 활성화된 경우에만 적용됩니다.

distributed_plan_force_exchange_kind

분산 쿼리 단계 간에 지정된 종류의 Exchange 연산자를 강제합니다. 가능한 값:
  • ” - 어떤 종류의 Exchange 연산자도 강제하지 않고 옵티마이저가 선택하도록 합니다.
  • ‘Persisted’ - 객체 스토리지의 임시 파일을 사용합니다.
  • ‘Streaming’ - 네트워크를 통해 Exchange 데이터를 스트리밍합니다.

distributed_plan_force_shuffle_aggregation

분산 쿼리 계획에서 PartialAggregation + Merge 대신 Shuffle 집계 전략을 사용합니다. Shuffle 전략이 올바른 결과를 생성할 수 없는 경우, 예를 들어 GROUPING SETS를 사용하거나 집계가 버킷 순서대로 결과를 생성해야 하는 경우에는 무시됩니다.

distributed_plan_max_rows_to_broadcast

분산 쿼리 계획에서 shuffle join 대신 broadcast join을 사용하기 위한 최대 행 수입니다. 규칙 기반 분산 플래너를 위한 휴리스틱입니다. 비용 기반 최적화기가 활성화되면 추정 비용에 따라 broadcast와 shuffle 중 하나를 선택하므로 이 설정은 적용되지 않습니다.

distributed_plan_optimize_exchanges

분산 쿼리 계획에서 불필요한 데이터 교환을 제거합니다. 디버깅을 위해 비활성화하십시오.

distributed_plan_prefer_replicas_over_workers

레플리카에서 실행할 수 있도록 분산 쿼리 계획을 직렬화합니다.

distributed_plan_read_in_order

분산 쿼리 계획에서 ORDER BY에 대한 순서 기반 읽기 최적화를 허용합니다. 테이블의 정렬 키를 정렬된 순서로 읽을 경우 스캔 후 정렬하는 대신 정렬을 건너뛰고 조기에 중지할 수 있습니다. 기본값은 비활성화입니다. 정렬을 분산하는 재작성은 자신이 감싸는 정렬이 입력이 이미 정렬되어 있다는 사실에 의존하지 않는다고 가정합니다. 그러나 이러한 의존성이 있는 정렬에는 순서를 보존하지 않는 exchange를 통해 행이 전달될 수 있습니다. 현재는 읽기와 정렬 사이에 exchange가 없는 형태만 안전합니다.

distributed_plan_workers_num

이 쿼리 실행에 사용할 상태 비저장 워커 수입니다. 0이면 분산 계획에 대한 상태 비저장 워커 임대가 비활성화됩니다.

distributed_plan_workers_provisioning_timeout_ms

실행 전 쿼리가 상태 비저장 워커를 프로비저닝하는 데 사용할 수 있는 총 실제 경과 시간(밀리초)입니다. 디스커버리 서비스에서 워커를 임대하고 연결할 수 있는지 확인하는 시간이 포함됩니다. 쿼리는 임대된 워커가 준비될 때까지 이 시간 한도 내에서 대기합니다. 시간이 만료되면 지금까지 확인된 워커로 쿼리를 진행하며, 사용 가능한 워커가 하나도 없으면 실패합니다. 0으로 설정하면 초기 임대 및 확인 단계에서만 대기하며 재시도하지 않습니다.
마지막 수정일 2026년 9월 26일