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。

您可以使用 log_queries_probability 设置来减少在 query_views_log 表中注册的查询数量。

列：

• hostname (LowCardinality(String)) — 执行查询的服务器的主机名。
• event_date (Date) — 上一个视图事件发生的日期。
• event_time (DateTime) — 视图执行结束的日期和时间。
• event_time_microseconds (DateTime) — 视图执行结束的日期和时间，微秒精度。
• 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 — 实时视图。
• view_query (String) — 视图执行的查询。
• view_target (String) — 视图目标表的名称。
• read_rows (UInt64) — 读取的行数。
• read_bytes (UInt64) — 读取的字节数。
• written_rows (UInt64) — 写入的行数。
• written_bytes (UInt64) — 写入的字节数。
• peak_memory_usage (Int64) — 在此视图上下文中，已分配和已释放内存之间的最大差值。
• ProfileEvents (Map(String, UInt64)) — 测量不同指标的 ProfileEvents。它们的描述可以在表 system.events 中找到。
• status (Enum8) — 视图的状态。值：
  • 'QueryStart' = 1 — 视图执行成功开始。不应出现。
  • 'QueryFinish' = 2 — 视图执行成功结束。
  • 'ExceptionBeforeStart' = 3 — 视图执行开始前的异常。
  • 'ExceptionWhileProcessing' = 4 — 视图执行中的异常。
• exception_code (Int32) — 异常代码。
• exception (String) — 异常消息。
• stack_trace (String) — 堆栈跟踪。如果查询成功完成，则为空字符串。

示例

查询：

结果：

另请参见

• system.query_log — 描述 query_log 系统表的内容，其中包含有关查询执行的常规信息。
• system.query_thread_log — 此表包含有关每个查询执行线程的信息。