Перейти к основному содержимому
Перейти к основному содержимому

system.query_views_log

Выполнение запросов в ClickHouse Cloud

Данные в этой системной таблице хранятся локально на каждом узле в ClickHouse Cloud. Поэтому для получения полного обзора всех данных требуется функция clusterAllReplicas. Подробности см. здесь.

Описание​

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

Чтобы начать логирование:

  1. Настройте параметры в разделе query_views_log.
  2. Установите log_query_views в 1.

Период сброса данных задаётся параметром flush_interval_milliseconds в разделе серверных настроек query_views_log. Чтобы принудительно выполнить сброс, используйте запрос SYSTEM FLUSH LOGS.

ClickHouse не удаляет данные из таблицы автоматически. Подробности см. во вводном разделе Introduction.

Вы можете использовать настройку log_queries_probability) для уменьшения количества запросов, регистрируемых в таблице query_views_log.

Столбцы​

  • hostname (LowCardinality(String)) — Имя хоста сервера, выполняющего запрос.
  • event_date (Date) — Дата, когда произошло последнее событие представления.
  • event_time (DateTime) — Дата и время завершения выполнения представления.
  • event_time_microseconds (DateTime64(6)) — Дата и время завершения выполнения представления с точностью до микросекунд.
  • view_duration_ms (UInt64) — Длительность выполнения представления (сумма всех его этапов) в миллисекундах.
  • initial_query_id (String) — Идентификатор исходного запроса (для распределённого выполнения запроса).
  • 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 — live view.
  • view_query (String) — Запрос, выполненный представлением.
  • view_target (String) — Имя целевой таблицы представления.
  • read_rows (UInt64) — Количество прочитанных строк.
  • read_bytes (UInt64) — Количество прочитанных байт.
  • written_rows (UInt64) — Количество записанных строк.
  • written_bytes (UInt64) — Количество записанных байт.
  • peak_memory_usage (Int64) — Максимальная разница между объёмом выделенной и освобождённой памяти в контексте этого представления.
  • 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:

См. также​