system.query_views_log

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.

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 pour plus de détails.

​

Description

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.
2. Définissez 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. Pour forcer le vidage, utilisez la requête SYSTEM FLUSH LOGS.

ClickHouse ne supprime pas automatiquement les données de la table. Voir Introduction pour plus de détails.

Vous pouvez utiliser le paramètre log_queries_probability) pour réduire le nombre de requêtes enregistrées dans la table query_views_log.

​

Colonnes

• hostname (LowCardinality(String)) — Nom d’hôte du serveur qui exécute la requête.
• event_date (Date) — Date à laquelle le dernier événement de la vue s’est produit.
• event_time (DateTime) — Date et heure auxquelles la vue a terminé son exécution.
• event_time_microseconds (DateTime64(6)) — Date et heure auxquelles la vue a terminé son exécution avec une précision à la microseconde.
• view_duration_ms (UInt64) — Durée d’exécution de la vue (somme de ses étapes), en millisecondes.
• initial_query_id (String) — ID de la requête initiale (pour l’exécution distribuée des requêtes).
• view_name (String) — Nom de la vue.
• view_uuid (UUID) — UUID de la vue.
• view_type (Enum8(‘Default’ = 1, ‘Materialized’ = 2, ‘Live’ = 3, ‘Window’ = 4)) — 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) — Requête exécutée par la vue.
• view_target (String) — Nom de la table cible de la vue.
• read_rows (UInt64) — Nombre de lignes lues.
• read_bytes (UInt64) — Nombre d’octets lus.
• written_rows (UInt64) — Nombre de lignes écrites.
• written_bytes (UInt64) — Nombre d’octets écrits.
• peak_memory_usage (Int64) — 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)) — ProfileEvents mesure différentes métriques. Leur description figure dans la table system.events.
• status (Enum8(‘QueryStart’ = 1, ‘QueryFinish’ = 2, ‘ExceptionBeforeStart’ = 3, ‘ExceptionWhileProcessing’ = 4)) — 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) — Code d’une exception.
• exception (String) — Message d’exception.
• stack_trace (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).

​

Exemple

Query

SELECT * FROM system.query_views_log LIMIT 1 \G;

Response

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:

​

Voir aussi