> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.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`. Дополнительные сведения см. [здесь](/ru/reference/system-tables/overview#system-tables-in-clickhouse-cloud).
</Info>

<div id="description">
  ## Описание
</div>

Содержит сведения о зависимых представлениях, которые выполняются при выполнении запроса, например об их типе или времени выполнения.

Чтобы начать ведение журнала:

1. Настройте параметры в разделе [query\_views\_log](/ru/reference/settings/server-settings/settings#query_views_log).
2. Установите [log\_query\_views](/ru/reference/settings/session-settings#log_query_views) в 1.

Период сброса данных задаётся параметром `flush_interval_milliseconds` в разделе настроек сервера [query\_views\_log](/ru/reference/settings/server-settings/settings#query_views_log). Чтобы принудительно выполнить сброс, используйте запрос [SYSTEM FLUSH LOGS](/ru/reference/statements/system#flush-logs).

ClickHouse не удаляет данные из таблицы автоматически. Подробнее см. в разделе [Введение](/ru/reference/system-tables/overview#system-tables-introduction).

Вы можете использовать настройку [log\_queries\_probability](/ru/reference/settings/session-settings#log_queries_probability)), чтобы сократить количество запросов, регистрируемых в таблице `query_views_log`.

<div id="columns">
  ## Столбцы
</div>

* `hostname` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — Имя хоста сервера, выполняющего запрос.
* `event_date` ([Date](/ru/reference/data-types/date)) — Дата, когда произошло последнее событие представления.
* `event_time` ([DateTime](/ru/reference/data-types/datetime)) — Дата и время завершения выполнения представления.
* `event_time_microseconds` ([DateTime64(6)](/ru/reference/data-types/datetime64)) — Дата и время завершения выполнения представления с точностью до микросекунд.
* `view_duration_ms` ([UInt64](/ru/reference/data-types/int-uint)) — Длительность выполнения представления (суммарно по всем его этапам) в миллисекундах.
* `initial_query_id` ([String](/ru/reference/data-types/string)) — ID исходного запроса (для выполнения распределённого запроса).
* `view_name` ([String](/ru/reference/data-types/string)) — Имя представления.
* `view_uuid` ([UUID](/ru/reference/data-types/uuid)) — UUID представления.
* `view_type` ([Enum8('Default' = 1, 'Materialized' = 2, 'Live' = 3, 'Window' = 4)](/ru/reference/data-types/enum)) — Тип представления. Значения: 'Default' = 1 — представления по умолчанию. Не должно появляться в этом журнале, 'Materialized' = 2 — materialized view, 'Live' = 3 — Live view.
* `view_query` ([String](/ru/reference/data-types/string)) — Запрос, выполненный представлением.
* `view_target` ([String](/ru/reference/data-types/string)) — Имя целевой таблицы представления.
* `read_rows` ([UInt64](/ru/reference/data-types/int-uint)) — Количество прочитанных строк.
* `read_bytes` ([UInt64](/ru/reference/data-types/int-uint)) — Количество прочитанных байт.
* `written_rows` ([UInt64](/ru/reference/data-types/int-uint)) — Количество записанных строк.
* `written_bytes` ([UInt64](/ru/reference/data-types/int-uint)) — Количество записанных байт.
* `peak_memory_usage` ([Int64](/ru/reference/data-types/int-uint)) — Максимальная разница между объёмом выделенной и освобождённой памяти в контексте этого представления.
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/ru/reference/data-types/map)) — ProfileEvents, измеряющие различные метрики. Их описание можно найти в таблице system.events.
* `status` ([Enum8('QueryStart' = 1, 'QueryFinish' = 2, 'ExceptionBeforeStart' = 3, 'ExceptionWhileProcessing' = 4)](/ru/reference/data-types/enum)) — Статус представления. Значения: 'QueryStart' = 1 — успешное начало выполнения представления. Не должно появляться, 'QueryFinish' = 2 — успешное завершение выполнения представления, 'ExceptionBeforeStart' = 3 — Исключение до начала выполнения представления, 'ExceptionWhileProcessing' = 4 — Исключение во время выполнения представления.
* `exception_code` ([Int32](/ru/reference/data-types/int-uint)) — Код исключения.
* `exception` ([String](/ru/reference/data-types/string)) — Сообщение об исключении.
* `stack_trace` ([String](/ru/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*/}
