Skip to main content
이러한 설정은 system.settings에서 확인할 수 있으며 source를 기반으로 자동 생성됩니다.

prefer_column_name_to_alias

쿼리 표현식과 절에서 별칭(alias) 대신 원래 컬럼명을 사용할지 여부를 설정합니다. 특히 별칭이 컬럼명과 동일한 경우 중요합니다. 자세한 내용은 Expression Aliases를 참조하십시오. 이 설정을 활성화하면 ClickHouse의 별칭 구문 규칙이 대부분의 다른 데이터베이스 엔진과 더 잘 호환됩니다. 가능한 값:
  • 0 — 컬럼명이 별칭으로 대체됩니다.
  • 1 — 컬럼명이 별칭으로 대체되지 않습니다.
예시 활성화 여부에 따른 차이: 쿼리:
결과:
쿼리:
결과:

prefer_external_sort_block_bytes

외부 정렬 시 최대 블록 바이트를 우선 사용하여 병합 중 메모리 사용량을 줄입니다.

prefer_global_in_and_join

IN/JOIN 연산자를 GLOBAL IN/GLOBAL JOIN으로 대체할지 여부를 설정합니다. 가능한 값:
  • 0 — 비활성화. IN/JOIN 연산자는 GLOBAL IN/GLOBAL JOIN으로 대체되지 않습니다.
  • 1 — 활성화. IN/JOIN 연산자가 GLOBAL IN/GLOBAL JOIN으로 대체됩니다.
사용법 SET distributed_product_mode=global은 분산 테이블의 쿼리 동작을 변경할 수 있지만, 로컬 테이블이나 외부 리소스의 테이블에는 적합하지 않습니다. 이런 경우 prefer_global_in_and_join 설정이 유용합니다. 예를 들어, 분산에 적합하지 않은 로컬 테이블이 있는 쿼리 서빙 노드가 있다고 가정하겠습니다. 이런 경우 분산 처리 중에 GLOBAL 키워드(GLOBAL IN/GLOBAL JOIN)를 사용해 해당 데이터를 즉시 분산시켜야 합니다. prefer_global_in_and_join의 또 다른 사용 사례는 외부 엔진으로 생성된 테이블에 액세스하는 경우입니다. 이 설정을 사용하면 이러한 테이블을 조인할 때 외부 SOURCES에 대한 호출 수를 줄일 수 있으며, 쿼리당 1번만 호출하면 됩니다. 관련 항목:
  • GLOBAL IN/GLOBAL JOIN 사용 방법에 대한 자세한 내용은 Distributed subqueries를 참조하십시오

prefer_localhost_replica

분산 쿼리를 처리할 때 localhost 레플리카를 우선적으로 사용하도록 설정하거나 비활성화합니다. 가능한 값:
  • 1 — localhost 레플리카가 있으면 ClickHouse는 항상 해당 레플리카로 쿼리를 보냅니다.
  • 0 — ClickHouse는 load_balancing 설정에 지정된 로드 밸런싱 전략을 사용합니다.
parallel_replicas_custom_key 없이 max_parallel_replicas를 사용하는 경우에는 이 설정을 비활성화하십시오. parallel_replicas_custom_key가 설정된 경우에는, 여러 세그먼트에 각각 여러 레플리카가 있는 클러스터에서 사용할 때만 이 설정을 비활성화하십시오. 단일 세그먼트와 여러 레플리카가 있는 클러스터에서 이 설정을 비활성화하면 부정적인 영향이 발생합니다.

prefer_warmed_unmerged_parts_seconds

ClickHouse Cloud에서만 효과가 있습니다. 병합된 파트가 이 값으로 지정된 초 수보다 덜 오래되었고 사전 워밍되지 않았지만(cache_populated_by_fetch 참조), 해당 파트의 모든 소스 파트가 사용 가능하며 사전 워밍된 상태라면 SELECT 쿼리는 대신 그 소스 파트들에서 읽습니다. Replicated-/SharedMergeTree에만 적용됩니다. 이 설정은 CacheWarmer가 해당 파트를 처리했는지만 확인합니다. 따라서 다른 방법으로 파트가 캐시에 가져와졌더라도 CacheWarmer가 해당 파트를 처리하기 전까지는 계속 콜드 상태로 간주되며, 워밍된 후 캐시에서 제거되었더라도 계속 웜 상태로 간주됩니다.
마지막 수정일 2026년 7월 24일