> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 包含运行查询时所执行的依赖视图信息的系统表，例如视图类型或执行时间。

# system.query_views_log

<Info>
  **在 ClickHouse Cloud 中查询**

  此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 `clusterAllReplicas` 函数。更多详情请参见[此处](/zh/reference/system-tables/overview#system-tables-in-clickhouse-cloud)。
</Info>

<div id="description">
  ## 说明
</div>

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

要开始记录日志：

1. 在 [query\_views\_log](/zh/reference/settings/server-settings/settings#query_views_log) 部分中配置参数。
2. 将 [log\_query\_views](/zh/reference/settings/session-settings#log_query_views) 设置为 1。

数据的刷新周期通过 [query\_views\_log](/zh/reference/settings/server-settings/settings#query_views_log) 服务器设置部分中的 `flush_interval_milliseconds` 参数来设置。要强制刷新，请使用 [SYSTEM FLUSH LOGS](/zh/reference/statements/system#flush-logs) 查询。

ClickHouse 不会自动从表中删除数据。更多信息，请参见[简介](/zh/reference/system-tables/overview#system-tables-introduction)。

你可以使用 [log\_queries\_probability](/zh/reference/settings/session-settings#log_queries_probability)) 设置，减少记录到 `query_views_log` 表中的查询数量。

<div id="columns">
  ## 列
</div>

* `hostname` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 执行该查询的 server 的主机名。
* `event_date` ([Date](/zh/reference/data-types/date)) — 该视图最后一次事件发生的日期。
* `event_time` ([DateTime](/zh/reference/data-types/datetime)) — 该视图执行完成的日期和时间。
* `event_time_microseconds` ([DateTime64(6)](/zh/reference/data-types/datetime64)) — 该视图执行完成的日期和时间，精确到微秒。
* `view_duration_ms` ([UInt64](/zh/reference/data-types/int-uint)) — 视图执行耗时 (其各阶段耗时总和) ，单位为毫秒。
* `initial_query_id` ([String](/zh/reference/data-types/string)) — 初始查询的 ID (用于 Distributed 查询执行) 。
* `view_name` ([String](/zh/reference/data-types/string)) — 视图名称。
* `view_uuid` ([UUID](/zh/reference/data-types/uuid)) — 视图的 UUID。
* `view_type` ([Enum8('Default' = 1, 'Materialized' = 2, 'Live' = 3, 'Window' = 4)](/zh/reference/data-types/enum)) — 视图类型。取值：'Default' = 1 — 默认视图，不应出现在此日志中；'Materialized' = 2 — Materialized 视图；'Live' = 3 — Live 视图。
* `view_query` ([String](/zh/reference/data-types/string)) — 视图执行的查询语句。
* `view_target` ([String](/zh/reference/data-types/string)) — 视图目标表的名称。
* `read_rows` ([UInt64](/zh/reference/data-types/int-uint)) — 读取的行数。
* `read_bytes` ([UInt64](/zh/reference/data-types/int-uint)) — 读取的字节数。
* `written_rows` ([UInt64](/zh/reference/data-types/int-uint)) — 写入的行数。
* `written_bytes` ([UInt64](/zh/reference/data-types/int-uint)) — 写入的字节数。
* `peak_memory_usage` ([Int64](/zh/reference/data-types/int-uint)) — 此视图上下文中已分配内存与已释放内存之差的最大值。
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/zh/reference/data-types/map)) — 用于衡量不同指标的 ProfileEvents。其说明可在 system.events 表中找到。
* `status` ([Enum8('QueryStart' = 1, 'QueryFinish' = 2, 'ExceptionBeforeStart' = 3, 'ExceptionWhileProcessing' = 4)](/zh/reference/data-types/enum)) — 视图状态。取值：'QueryStart' = 1 — 视图执行成功启动，不应出现；'QueryFinish' = 2 — 视图执行成功结束；'ExceptionBeforeStart' = 3 — 视图执行开始前发生异常；'ExceptionWhileProcessing' = 4 — 视图执行过程中发生异常。
* `exception_code` ([Int32](/zh/reference/data-types/int-uint)) — 异常代码。
* `exception` ([String](/zh/reference/data-types/string)) — 异常消息。
* `stack_trace` ([String](/zh/reference/data-types/string)) — 堆栈跟踪。如果查询成功完成，则为空字符串。

**别名：**

* `ProfileEvents.Names` — `mapKeys(ProfileEvents)` 的别名。
* `ProfileEvents.Values` — `mapValues(ProfileEvents)` 的别名。

<div id="example">
  ## 示例
</div>

```sql title="Query" theme={null}
SELECT * FROM system.query_views_log LIMIT 1 \G;
```

```text title="Response" theme={null}
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:
```

<div id="see-also">
  ## 另请参阅
</div>

{/*AUTOGENERATED_END*/}