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

​
log_queries

쿼리 로깅을 활성화합니다. 이 설정이 적용되면 ClickHouse에 전송된 쿼리는 query_log 서버 구성 매개변수의 규칙에 따라 기록됩니다. 예시:

​
log_queries_cut_to_length

쿼리 길이가 지정된 임계값(바이트 단위)보다 크면 query log에 기록할 때 쿼리를 잘라냅니다. 또한 일반 텍스트 로그에 출력되는 쿼리의 길이도 제한합니다.

​
log_queries_min_query_duration_ms

활성화된 경우(0이 아닌 값), 이 설정값보다 더 빠른 쿼리는 로그에 기록되지 않습니다(MySQL Slow Query Log의 long_query_time와 유사하다고 볼 수 있습니다). 즉, 이러한 쿼리는 다음 테이블에서 찾을 수 없습니다.
  • system.query_log
  • system.query_thread_log
다음 유형의 쿼리만 로그에 기록됩니다.
  • QUERY_FINISH
  • EXCEPTION_WHILE_PROCESSING
  • 유형: 밀리초
  • 기본값: 0(모든 쿼리)

​
log_queries_min_type

기록할 query_log의 최소 유형입니다. Possible values:
  • QUERY_START (=1)
  • QUERY_FINISH (=2)
  • EXCEPTION_BEFORE_START (=3)
  • EXCEPTION_WHILE_PROCESSING (=4)
query_log에 기록될 항목을 제한하는 데 사용할 수 있습니다. 예를 들어 오류에만 관심이 있다면 EXCEPTION_WHILE_PROCESSING을 사용할 수 있습니다:

​
log_queries_probability

지정된 확률에 따라 무작위로 선택된 일부 쿼리만 query_log, query_thread_log, query_views_log 시스템 테이블(system tables)에 기록하도록 허용합니다. 초당 쿼리 수가 매우 많을 때 부하를 줄이는 데 도움이 됩니다. 가능한 값:
  • 0 — 쿼리가 시스템 테이블에 기록되지 않습니다.
  • [0..1] 범위의 양의 부동소수점 수. 예를 들어 설정 값이 0.5이면 전체 쿼리 중 약 절반이 시스템 테이블에 기록됩니다.
  • 1 — 모든 쿼리가 시스템 테이블에 기록됩니다.
마지막 수정일 2026년 7월 23일