본문으로 바로가기
본문으로 바로가기

system.query_views_log

ClickHouse Cloud에서 쿼리하기

이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 조회하려면 clusterAllReplicas 함수를 사용해야 합니다. 자세한 내용은 여기를 참고하십시오.

설명​

쿼리를 실행할 때 함께 실행되는 종속 뷰에 대한 정보(예: 뷰 유형, 실행 시간 등)를 포함합니다.

로깅을 시작하려면:

  1. query_views_log 섹션에서 파라미터를 구성합니다.
  2. log_query_views를 1로 설정합니다.

데이터 플러시 주기는 query_views_log 서버 설정 섹션의 flush_interval_milliseconds 파라미터로 설정합니다. 강제로 플러시하려면 SYSTEM FLUSH LOGS 쿼리를 사용합니다.

ClickHouse는 이 테이블의 데이터를 자동으로 삭제하지 않습니다. 자세한 내용은 Introduction을 참고하십시오.

query_views_log 테이블에 기록되는 쿼리 수를 줄이려면 log_queries_probability SETTING을 사용할 수 있습니다.

컬럼​

  • hostname (LowCardinality(String)) — 쿼리를 실행하는 서버의 호스트명입니다.
  • event_date (Date) — 뷰의 마지막 이벤트가 발생한 날짜입니다.
  • event_time (DateTime) — 뷰 실행이 완료된 날짜와 시간입니다.
  • event_time_microseconds (DateTime64(6)) — 뷰 실행이 완료된 날짜와 시간이며, 마이크로초 정밀도를 가집니다.
  • view_duration_ms (UInt64) — 뷰 실행 시간(각 단계의 합계)으로, 밀리초 단위입니다.
  • initial_query_id (String) — 초기 쿼리의 ID입니다(Distributed 쿼리 실행용).
  • view_name (String) — 뷰의 이름입니다.
  • view_uuid (UUID) — 뷰의 UUID입니다.
  • view_type (Enum8('Default' = 1, 'Materialized' = 2, 'Live' = 3, 'Window' = 4)) — 뷰의 유형입니다. 값: 'Default' = 1 — 기본 뷰입니다. 이 로그에는 나타나지 않아야 합니다. 'Materialized' = 2 — materialized view, 'Live' = 3 — 라이브 view.
  • view_query (String) — 뷰가 실행한 쿼리입니다.
  • view_target (String) — 뷰 대상 테이블의 이름입니다.
  • read_rows (UInt64) — 읽은 행 수입니다.
  • read_bytes (UInt64) — 읽은 바이트 수입니다.
  • written_rows (UInt64) — 기록한 행 수입니다.
  • written_bytes (UInt64) — 기록한 바이트 수입니다.
  • peak_memory_usage (Int64) — 이 뷰의 Context에서 할당된 메모리 양과 해제된 메모리 양 사이의 최대 차이입니다.
  • ProfileEvents (Map(LowCardinality(String), UInt64)) — 서로 다른 메트릭을 측정하는 ProfileEvents입니다. 이에 대한 설명은 system.events 테이블에서 확인할 수 있습니다.
  • status (Enum8('QueryStart' = 1, 'QueryFinish' = 2, 'ExceptionBeforeStart' = 3, 'ExceptionWhileProcessing' = 4)) — 뷰의 상태입니다. 값: 'QueryStart' = 1 — 뷰 실행이 성공적으로 시작된 상태입니다. 나타나지 않아야 합니다. 'QueryFinish' = 2 — 뷰 실행이 성공적으로 종료된 상태입니다, 'ExceptionBeforeStart' = 3 — 뷰 실행이 시작되기 전에 예외가 발생한 상태입니다., 'ExceptionWhileProcessing' = 4 — 뷰 실행 중에 예외가 발생한 상태입니다.
  • exception_code (Int32) — 예외 코드입니다.
  • exception (String) — 예외 메시지입니다.
  • stack_trace (String) — 스택 추적입니다. 쿼리가 성공적으로 완료된 경우 빈 문자열입니다.

별칭:

  • ProfileEvents.Names — mapKeys(ProfileEvents)의 별칭입니다.
  • ProfileEvents.Values — mapValues(ProfileEvents)의 별칭입니다.

예시​

쿼리:

SELECT * FROM system.query_views_log LIMIT 1 \G;

결과:

Row 1:
──────
hostname:                clickhouse.eu-central1.internal
event_date:              2021-06-22
event_time:              2021-06-22 13:23:07
event_time_microseconds: 2021-06-22 13:23:07.738221
view_duration_ms:        0
initial_query_id:        c3a1ac02-9cad-479b-af54-9e9c0a7afd70
view_name:               default.matview_inner
view_uuid:               00000000-0000-0000-0000-000000000000
view_type:               Materialized
view_query:              SELECT * FROM default.table_b
view_target:             default.`.inner.matview_inner`
read_rows:               4
read_bytes:              64
written_rows:            2
written_bytes:           32
peak_memory_usage:       4196188
ProfileEvents:           {'FileOpen':2,'WriteBufferFromFileDescriptorWrite':2,'WriteBufferFromFileDescriptorWriteBytes':187,'IOBufferAllocs':3,'IOBufferAllocBytes':3145773,'FunctionExecute':3,'DiskWriteElapsedMicroseconds':13,'InsertedRows':2,'InsertedBytes':16,'SelectedRows':4,'SelectedBytes':48,'ContextLock':16,'RWLockAcquiredReadLocks':1,'RealTimeMicroseconds':698,'SoftPageFaults':4,'OSReadChars':463}
status:                  QueryFinish
exception_code:          0
exception:
stack_trace:

관련 항목​