> ## 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` 関数を使用する必要があります。詳細については、[こちら](/ja/reference/system-tables/overview#system-tables-in-clickhouse-cloud)を参照してください。
</Info>

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

クエリ実行時に実行される依存ビューに関する情報 (たとえば、ビューの種類や実行時間など) が含まれます。

ログの記録を開始するには、次の手順を実行します。

1. [query\_views\_log](/ja/reference/settings/server-settings/settings#query_views_log) セクションでパラメータを設定します。
2. [log\_query\_views](/ja/reference/settings/session-settings#log_query_views) を 1 に設定します。

データのフラッシュ間隔は、[query\_views\_log](/ja/reference/settings/server-settings/settings#query_views_log) サーバー設定セクションの `flush_interval_milliseconds` パラメータで設定します。フラッシュを強制するには、[SYSTEM FLUSH LOGS](/ja/reference/statements/system#flush-logs) クエリを使用します。

ClickHouse はテーブルからデータを自動では削除しません。詳細については、[Introduction](/ja/reference/system-tables/overview#system-tables-introduction) を参照してください。

`query_views_log` テーブルに記録されるクエリ数を減らすには、[log\_queries\_probability](/ja/reference/settings/session-settings#log_queries_probability)) 設定を使用できます。

<div id="columns">
  ## カラム
</div>

* `hostname` ([LowCardinality(String)](/ja/reference/data-types/lowcardinality)) — クエリを実行するサーバーのホスト名。
* `event_date` ([Date](/ja/reference/data-types/date)) — ビューで最後のイベントが発生した日付。
* `event_time` ([DateTime](/ja/reference/data-types/datetime)) — ビューの実行が完了した日時。
* `event_time_microseconds` ([DateTime64(6)](/ja/reference/data-types/datetime64)) — ビューの実行が完了した日時 (マイクロ秒精度) 。
* `view_duration_ms` ([UInt64](/ja/reference/data-types/int-uint)) — ビューの実行時間 (各ステージの合計、ミリ秒単位) 。
* `initial_query_id` ([String](/ja/reference/data-types/string)) — 初期クエリの ID (分散クエリ実行時) 。
* `view_name` ([String](/ja/reference/data-types/string)) — ビュー名。
* `view_uuid` ([UUID](/ja/reference/data-types/uuid)) — ビューの UUID。
* `view_type` ([Enum8('Default' = 1, 'Materialized' = 2, 'Live' = 3, 'Window' = 4)](/ja/reference/data-types/enum)) — ビューの種類。値: 'Default' = 1 — デフォルトビュー。このログには現れないはずです。'Materialized' = 2 — materialized view、'Live' = 3 — Live view。
* `view_query` ([String](/ja/reference/data-types/string)) — ビューが実行したクエリ。
* `view_target` ([String](/ja/reference/data-types/string)) — ビューのターゲットテーブル名。
* `read_rows` ([UInt64](/ja/reference/data-types/int-uint)) — 読み取った行数。
* `read_bytes` ([UInt64](/ja/reference/data-types/int-uint)) — 読み取ったバイト数。
* `written_rows` ([UInt64](/ja/reference/data-types/int-uint)) — 書き込んだ行数。
* `written_bytes` ([UInt64](/ja/reference/data-types/int-uint)) — 書き込んだバイト数。
* `peak_memory_usage` ([Int64](/ja/reference/data-types/int-uint)) — このビューのコンテキストにおける、割り当て済みメモリ量と解放済みメモリ量の差の最大値。
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/ja/reference/data-types/map)) — 各種メトリクスを測定する ProfileEvents。各項目の説明は system.events テーブルにあります。
* `status` ([Enum8('QueryStart' = 1, 'QueryFinish' = 2, 'ExceptionBeforeStart' = 3, 'ExceptionWhileProcessing' = 4)](/ja/reference/data-types/enum)) — ビューのステータス。値: 'QueryStart' = 1 — ビュー実行の開始に成功。現れないはずです。'QueryFinish' = 2 — ビュー実行の正常終了、'ExceptionBeforeStart' = 3 — ビュー実行開始前の例外、'ExceptionWhileProcessing' = 4 — ビュー実行中の例外。
* `exception_code` ([Int32](/ja/reference/data-types/int-uint)) — 例外コード。
* `exception` ([String](/ja/reference/data-types/string)) — 例外メッセージ。
* `stack_trace` ([String](/ja/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*/}
