query_views_log
包含有关运行查询时执行的依赖视图的信息,例如视图类型或执行时间。
要开始记录
- 在 query_views_log 部分配置参数。
- 将 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
(DateTime) — 视图完成执行的日期和时间(精确到微秒)。view_duration_ms
(UInt64) — 视图执行时长(其所有阶段的总和),以毫秒为单位。initial_query_id
(String) — 初始查询的 ID(对于分布式查询执行)。view_name
(String) — 视图的名称。view_uuid
(UUID) — 视图的 UUID。view_type
(Enum8) — 视图的类型。值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) — 堆栈跟踪。如果查询已成功完成,则为空字符串。
示例
查询
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:
另请参阅
- system.query_log — 包含有关查询执行的常规信息的
query_log
系统表的描述。 - system.query_thread_log — 此表包含有关每个查询执行线程的信息。