> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 쿼리 실행 시 함께 실행되는 종속 뷰에 대한 정보를 포함하는 시스템 테이블로, 예를 들어 뷰 유형이나 실행 시간 등의 정보를 제공합니다.

# system.query_views_log

<Info>
  **ClickHouse Cloud에서 쿼리하기**

  이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 모두 확인하려면 `clusterAllReplicas` 함수를 사용해야 합니다. 자세한 내용은 [여기](/ko/reference/system-tables/overview#system-tables-in-clickhouse-cloud)를 참조하십시오.
</Info>

<div id="description">
  ## 설명
</div>

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

로깅을 시작하려면 다음과 같이 하십시오.

1. [query\_views\_log](/ko/reference/settings/server-settings/settings#query_views_log) 섹션에서 매개변수를 구성합니다.
2. [log\_query\_views](/ko/reference/settings/session-settings#log_query_views)를 1로 설정합니다.

데이터 플러시 주기는 [query\_views\_log](/ko/reference/settings/server-settings/settings#query_views_log) server settings 섹션의 `flush_interval_milliseconds` 매개변수에서 설정합니다. 플러시를 강제로 수행하려면 [SYSTEM FLUSH LOGS](/ko/reference/statements/system#flush-logs) 쿼리를 사용하십시오.

ClickHouse는 테이블의 데이터를 자동으로 삭제하지 않습니다. 자세한 내용은 [Introduction](/ko/reference/system-tables/overview#system-tables-introduction)을 참조하십시오.

`query_views_log` 테이블에 기록되는 쿼리 수를 줄이려면 [log\_queries\_probability](/ko/reference/settings/session-settings#log_queries_probability)) 설정을 사용할 수 있습니다.

<div id="columns">
  ## 컬럼
</div>

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

**별칭:**

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

<div id="example">
  ## 예시
</div>

```sql title="Query" theme={null}
SELECT * FROM system.query_views_log LIMIT 1 \G;
```

```text title="Response" theme={null}
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:
```

<div id="see-also">
  ## 관련 항목
</div>

{/*AUTOGENERATED_END*/}