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

> Table système contenant des informations sur les vues dépendantes exécutées lors d'une requête, comme le type de vue ou le temps d’exécution.

# system.query_views_log

<Info>
  **Interroger dans ClickHouse Cloud**

  Les données de cette table système sont stockées localement sur chaque nœud de ClickHouse Cloud. Pour obtenir une vue complète de l’ensemble des données, il faut donc utiliser la fonction `clusterAllReplicas`. Consultez [cette page](/fr/reference/system-tables/overview#system-tables-in-clickhouse-cloud) pour plus de détails.
</Info>

<div id="description">
  ## Description
</div>

Contient des informations sur les vues dépendantes exécutées lors de l’exécution d’une requête, par exemple le type de vue ou le temps d’exécution.

Pour activer la journalisation :

1. Configurez les paramètres dans la section [query\_views\_log](/fr/reference/settings/server-settings/settings#query_views_log).
2. Définissez [log\_query\_views](/fr/reference/settings/session-settings#log_query_views) sur 1.

L’intervalle de vidage des données est défini dans le paramètre `flush_interval_milliseconds` de la section des paramètres du serveur [query\_views\_log](/fr/reference/settings/server-settings/settings#query_views_log). Pour forcer le vidage, utilisez la requête [SYSTEM FLUSH LOGS](/fr/reference/statements/system#flush-logs).

ClickHouse ne supprime pas automatiquement les données de la table. Voir [Introduction](/fr/reference/system-tables/overview#system-tables-introduction) pour plus de détails.

Vous pouvez utiliser le paramètre [log\_queries\_probability](/fr/reference/settings/session-settings#log_queries_probability)) pour réduire le nombre de requêtes enregistrées dans la table `query_views_log`.

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

* `hostname` ([LowCardinality(String)](/fr/reference/data-types/lowcardinality)) — Nom d’hôte du serveur qui exécute la requête.
* `event_date` ([Date](/fr/reference/data-types/date)) — Date à laquelle le dernier événement de la vue s’est produit.
* `event_time` ([DateTime](/fr/reference/data-types/datetime)) — Date et heure auxquelles la vue a terminé son exécution.
* `event_time_microseconds` ([DateTime64(6)](/fr/reference/data-types/datetime64)) — Date et heure auxquelles la vue a terminé son exécution avec une précision à la microseconde.
* `view_duration_ms` ([UInt64](/fr/reference/data-types/int-uint)) — Durée d’exécution de la vue (somme de ses étapes), en millisecondes.
* `initial_query_id` ([String](/fr/reference/data-types/string)) — ID de la requête initiale (pour l’exécution distribuée des requêtes).
* `view_name` ([String](/fr/reference/data-types/string)) — Nom de la vue.
* `view_uuid` ([UUID](/fr/reference/data-types/uuid)) — UUID de la vue.
* `view_type` ([Enum8('Default' = 1, 'Materialized' = 2, 'Live' = 3, 'Window' = 4)](/fr/reference/data-types/enum)) — Type de la vue. Valeurs : 'Default' = 1 — Vues par défaut. Ne devrait pas apparaître dans ce journal, 'Materialized' = 2 — Vues matérialisées, 'Live' = 3 — Vues Live.
* `view_query` ([String](/fr/reference/data-types/string)) — Requête exécutée par la vue.
* `view_target` ([String](/fr/reference/data-types/string)) — Nom de la table cible de la vue.
* `read_rows` ([UInt64](/fr/reference/data-types/int-uint)) — Nombre de lignes lues.
* `read_bytes` ([UInt64](/fr/reference/data-types/int-uint)) — Nombre d’octets lus.
* `written_rows` ([UInt64](/fr/reference/data-types/int-uint)) — Nombre de lignes écrites.
* `written_bytes` ([UInt64](/fr/reference/data-types/int-uint)) — Nombre d’octets écrits.
* `peak_memory_usage` ([Int64](/fr/reference/data-types/int-uint)) — Différence maximale entre la quantité de mémoire allouée et celle libérée dans le contexte de cette vue.
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/fr/reference/data-types/map)) — `ProfileEvents` mesure différentes métriques. Leur description figure dans la table system.events.
* `status` ([Enum8('QueryStart' = 1, 'QueryFinish' = 2, 'ExceptionBeforeStart' = 3, 'ExceptionWhileProcessing' = 4)](/fr/reference/data-types/enum)) — Statut de la vue. Valeurs : 'QueryStart' = 1 — Démarrage réussi de l’exécution de la vue. Ne devrait pas apparaître, 'QueryFinish' = 2 — Fin réussie de l’exécution de la vue, 'ExceptionBeforeStart' = 3 — Exception avant le début de l’exécution de la vue, 'ExceptionWhileProcessing' = 4 — Exception pendant l’exécution de la vue.
* `exception_code` ([Int32](/fr/reference/data-types/int-uint)) — Code d’une exception.
* `exception` ([String](/fr/reference/data-types/string)) — Message d’exception.
* `stack_trace` ([String](/fr/reference/data-types/string)) — Stack trace. Chaîne vide si la requête s’est terminée avec succès.

**Alias :**

* `ProfileEvents.Names` — alias de `mapKeys(ProfileEvents)`.
* `ProfileEvents.Values` — alias de `mapValues(ProfileEvents)`.

<div id="example">
  ## Exemple
</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">
  ## Voir aussi
</div>

{/*AUTOGENERATED_END*/}
