system.query_views_log

在 ClickHouse Cloud 中查询

该系统表中的数据在 ClickHouse Cloud 的每个节点上本地保存。因此，要获得所有数据的完整视图，需要使用 clusterAllReplicas 函数。有关更多详细信息，请参见 here。

包含有关在运行查询时执行的依赖视图的信息，例如视图类型或执行时间。

要开始记录：

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 — 此表包含有关每个查询执行线程的信息。