跳转到主内容
跳转到主内容

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 不会自动从该表中删除数据。更多详情参见简介。

可以使用 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) — 初始查询的 ID (用于分布式查询执行) 。
  • 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:

另请参见​