Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

use_query_* 세션 설정

이러한 설정은 system.settings에서 확인할 수 있으며, 소스 코드를 기반으로 자동 생성됩니다.

use_query_cache

유형
Bool
기본값
0

이 설정을 활성화하면 SELECT 쿼리에서 쿼리 캐시를 사용할 수 있습니다. 매개변수 enable_reads_from_query_cacheenable_writes_to_query_cache는 캐시 사용 방식을 더 세부적으로 제어합니다.

가능한 값:

  • 0 - 비활성화됨
  • 1 - 활성화됨

use_query_condition_cache

유형
Bool
기본값
1
버전 이력
버전기본값설명
25.41새로운 최적화
25.30새 설정입니다.

쿼리 조건 캐시를 활성화합니다. 이 캐시는 WHERE 절의 조건을 만족하지 않는 데이터 파트(data part)의 그래뉼 범위를 저장하고, 이 정보를 후속 쿼리에서 임시 인덱스로 재사용합니다.

가능한 값:

  • 0 - 비활성화됨
  • 1 - 활성화됨

use_query_condition_cache_for_top_k

유형
Bool
기본값
1
버전 이력
버전기본값설명
26.81`ORDER BY ... LIMIT n` (TopK) 읽기에 쿼리 조건 캐시를 적용하기 위한 새로운 설정입니다. 기본적으로 활성화되어 있습니다. 이 기능은 26.7에서 비활성화되어 있으므로, 이전 버전과의 `compatibility`를 설정하면 비활성화된 상태가 유지됩니다.

ORDER BY <column> LIMIT n (TopK) 최적화(동적 필터링 또는 스킵 인덱스 기반)를 사용하는 쿼리에 쿼리 조건 캐시를 활성화합니다. 비활성화하면 이러한 읽기는 캐시를 조회하거나 캐시에 데이터를 채우지 않습니다.

이러한 쿼리는 실행 중 런타임 임계값에 따라 그래뉼을 제외할 수 있으므로, 캐시 엔트리는 TopK 계획 매개변수와 읽은 파트 집합을 기준으로 분할됩니다. use_query_condition_cache도 활성화하지 않으면 이 설정은 효과가 없습니다.

사용 가능한 값:

  • 0 - 비활성화됨
  • 1 - 활성화됨
Navigation