Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

query_cache_* 세션 설정

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

query_cache_compress_entries

유형
Bool
기본값
1

쿼리 캐시의 엔트리를 압축합니다. 쿼리 캐시의 메모리 사용량을 줄이는 대신, 캐시에 대한 삽입 및 읽기가 느려집니다.

가능한 값:

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

query_cache_for_subqueries

유형
Bool
기본값
0
버전 이력
버전기본값설명
26.50모든 서브쿼리에 `use_query_cache`가 전파되도록 활성화하는 새로운 설정입니다. 이 설정이 없으면 서브쿼리는 각 서브쿼리에서 명시적으로 `SETTINGS use_query_cache = true`를 설정해 옵트인한 경우에만 캐시됩니다.

활성화하면 서브쿼리 결과를 쿼리 캐시에 저장하고, 여기서 읽어올 수 있습니다. 이렇게 하면 use_query_cache가 모든 서브쿼리에 전파됩니다.

가능한 값:

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

query_cache_max_entries

유형
UInt64
기본값
0

현재 사용자가 쿼리 캐시에 저장할 수 있는 쿼리 결과의 최대 개수입니다. 0은 무제한을 의미합니다.

가능한 값:

  • 0 이상의 정수

query_cache_max_size_in_bytes

유형
UInt64
기본값
0

현재 사용자가 쿼리 캐시에 할당할 수 있는 최대 메모리 크기(바이트)입니다. 0은 제한이 없음을 의미합니다.

가능한 값:

  • 0 이상의 정수.

query_cache_min_query_duration

유형
Milliseconds
기본값
0

쿼리 결과가 쿼리 캐시에 저장되려면 쿼리가 최소 몇 밀리초 동안 실행되어야 하는지를 지정합니다.

가능한 값:

  • 0 이상의 정수.

query_cache_min_query_runs

유형
UInt64
기본값
0

결과가 쿼리 캐시에 저장되기 전에 SELECT 쿼리가 실행되어야 하는 최소 횟수입니다.

가능한 값:

  • 0 이상의 정수.

query_cache_nondeterministic_function_handling

유형
QueryResultCacheNondeterministicFunctionHandling
기본값
throw

rand() 또는 now()와 같은 비결정적 함수가 포함된 SELECT 쿼리를 쿼리 캐시에서 어떻게 처리할지 제어합니다.

가능한 값:

  • 'throw' - 예외를 발생시키고 쿼리 결과를 캐시하지 않습니다.
  • 'save' - 쿼리 결과를 캐시합니다.
  • 'ignore' - 쿼리 결과를 캐시하지 않고 예외도 발생시키지 않습니다.

query_cache_share_between_users

유형
Bool
기본값
0

이 설정을 활성화하면 쿼리 캐시에 캐시된 SELECT 쿼리 결과를 다른 사용자도 읽을 수 있습니다. 보안상의 이유로 이 설정을 활성화하는 것은 권장되지 않습니다.

가능한 값:

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

query_cache_squash_partial_results

유형
Bool
기본값
1

부분 결과 블록을 max_block_size 크기의 블록으로 병합합니다. 쿼리 캐시에 대한 삽입 성능은 저하되지만, 캐시 엔트리의 압축 효율은 향상됩니다(query_cache_compress-entries 참조).

가능한 값:

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

query_cache_system_table_handling

유형
QueryResultCacheSystemTableHandling
기본값
throw
버전 이력
버전기본값설명
24.4throw쿼리 캐시가 더 이상 시스템 테이블에 대한 쿼리 결과를 캐시하지 않습니다

쿼리 캐시가 시스템 테이블, 즉 system.*information_schema.* 데이터베이스의 테이블에 대한 SELECT 쿼리를 어떻게 처리할지 제어합니다.

가능한 값:

  • 'throw' - 예외를 발생시키고 쿼리 결과를 캐시하지 않습니다.
  • 'save' - 쿼리 결과를 캐시합니다.
  • 'ignore' - 쿼리 결과를 캐시하지 않으며 예외도 발생시키지 않습니다.

query_cache_tag

버전 이력
버전기본값설명
24.8쿼리 캐시 설정에 레이블을 지정하기 위한 새로운 설정.

쿼리 캐시 엔트리의 레이블 역할을 하는 문자열입니다. 동일한 쿼리라도 태그가 다르면 쿼리 캐시에서는 서로 다른 것으로 간주됩니다.

가능한 값:

  • 임의의 문자열

query_cache_ttl

유형
Seconds
기본값
60

이 시간이 지나면 쿼리 캐시의 엔트리가 오래된 상태가 됩니다.

가능한 값:

  • 0 이상인 정수.
Navigation