Passer au contenu principal
Interroger dans ClickHouse CloudLes 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 threads qui exécutent des requêtes, par exemple le nom du thread, son heure de début et la durée de traitement de la requête. Pour activer la journalisation :
  1. Configurez les paramètres dans la section query_thread_log.
  2. Définissez log_query_threads sur 1.
La période de vidage des données est définie par le paramètre flush_interval_milliseconds dans la section des paramètres serveur query_thread_log. Pour forcer le vidage, utilisez la requête SYSTEM FLUSH LOGS. ClickHouse ne supprime pas automatiquement les données de la table. Consultez 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_thread_log.

Colonnes

  • hostname (LowCardinality(String)) — Nom d’hôte du serveur exécutant la requête.
  • event_date (Date) — Date à laquelle le thread a terminé l’exécution de la requête.
  • event_time (DateTime) — Date et heure auxquelles le thread a terminé l’exécution de la requête.
  • event_time_microseconds (DateTime64(6)) — Date et heure auxquelles le thread a terminé l’exécution de la requête avec une précision à la microseconde.
  • query_start_time (DateTime) — Heure de début de l’exécution de la requête.
  • query_start_time_microseconds (DateTime64(6)) — Heure de début de l’exécution de la requête avec une précision à la microseconde.
  • query_duration_ms (UInt64) — Durée d’exécution de la requête.
  • read_rows (UInt64) — Nombre de lignes lues.
  • read_bytes (UInt64) — Nombre d’octets lus.
  • written_rows (UInt64) — Pour les requêtes INSERT, nombre de lignes écrites. Pour les autres requêtes, la valeur de la colonne est 0.
  • written_bytes (UInt64) — Pour les requêtes INSERT, nombre d’octets écrits. Pour les autres requêtes, la valeur de la colonne est 0.
  • memory_usage (Int64) — Différence entre la quantité de mémoire allouée et la quantité de mémoire libérée dans le contexte de ce thread.
  • peak_memory_usage (Int64) — Différence maximale entre la quantité de mémoire allouée et la quantité de mémoire libérée dans le contexte de ce thread.
  • thread_name (LowCardinality(String)) — Nom du thread.
  • thread_id (UInt64) — ID interne du thread.
  • master_thread_id (UInt64) — ID initial du thread initial au niveau du système d’exploitation.
  • current_database (LowCardinality(String)) — Nom de la base de données courante.
  • query (String) — Texte de la requête.
  • normalized_query_hash (UInt64) — Hachage de la requête normalisée — avec les constantes effacées, etc.
  • is_initial_query (UInt8) — Type de requête. Valeurs possibles : 1 — la requête a été initiée par le client, 0 — la requête a été initiée par une autre requête pour l’exécution distribuée des requêtes.
  • connection_address (IPv6) — Adresse IP du client depuis laquelle la connexion a été établie. En cas de connexion via un proxy, il s’agira de l’adresse du proxy.
  • connection_port (UInt16) — Port du client depuis lequel la connexion a été établie. En cas de connexion via un proxy, il s’agira du port du proxy.
  • user (LowCardinality(String)) — Nom de l’utilisateur qui a initié la requête en cours.
  • query_id (String) — ID de la requête.
  • address (IPv6) — Adresse IP utilisée pour effectuer la requête. En cas de connexion via un proxy et si auth_use_forwarded_address est défini, il s’agira de l’adresse du client au lieu de celle du proxy.
  • port (UInt16) — Port client utilisé pour effectuer la requête. En cas de connexion via un proxy, si auth_use_forwarded_address est défini, il s’agit du port du client plutôt que de celui du proxy.
  • initial_user (LowCardinality(String)) — Nom de l’utilisateur qui a exécuté la requête initiale (pour l’exécution distribuée des requêtes).
  • initial_query_id (String) — ID de la requête initiale (pour l’exécution distribuée des requêtes).
  • initial_address (IPv6) — Adresse IP depuis laquelle la requête parente a été lancée.
  • initial_port (UInt16) — Port client utilisé pour effectuer la requête parente.
  • initial_query_start_time (DateTime) — Heure de début d’exécution de la requête initiale.
  • initial_query_start_time_microseconds (DateTime64(6)) — Heure de début d’exécution de la requête initiale
  • authenticated_user (LowCardinality(String)) — Nom de l’utilisateur authentifié dans la session.
  • interface (UInt8) — Interface depuis laquelle la requête a été lancée. Valeurs possibles : 1 — TCP, 2 — HTTP.
  • is_secure (UInt8) — Indicateur précisant si la connexion était sécurisée.
  • os_user (LowCardinality(String)) — Nom d’utilisateur du système d’exploitation qui exécute clickhouse-client.
  • client_hostname (LowCardinality(String)) — Nom d’hôte de la machine cliente sur laquelle s’exécute clickhouse-client ou un autre client TCP.
  • client_name (LowCardinality(String)) — Nom de clickhouse-client ou d’un autre client TCP.
  • client_agent (LowCardinality(String)) — Agent de codage IA ayant invoqué le client (par exemple, claude-code ou cursor), détecté à partir des variables d’environnement. Vide si aucun agent n’a été détecté.
  • client_revision (UInt32) — Révision de clickhouse-client ou d’un autre client TCP.
  • client_version_major (UInt32) — Version majeure de clickhouse-client ou d’un autre client TCP.
  • client_version_minor (UInt32) — Version mineure de clickhouse-client ou d’un autre client TCP.
  • client_version_patch (UInt32) — Composant de correctif de la version de clickhouse-client ou d’un autre client TCP.
  • script_query_number (UInt32) — Numéro séquentiel de la requête dans un script multi-requêtes.
  • script_line_number (UInt32) — Numéro de ligne, dans un script multi-requêtes, où commence la requête actuelle.
  • http_method (UInt8) — Méthode HTTP ayant lancé la requête. Valeurs possibles : 0 — la requête a été lancée depuis l’interface TCP, 1 — la méthode GET a été utilisée, 2 — la méthode POST a été utilisée.
  • http_user_agent (LowCardinality(String)) — En-tête UserAgent transmis dans la requête HTTP.
  • http_referer (String) — En-tête HTTP Referer transmis dans la requête HTTP (contient une adresse absolue ou partielle de la page qui effectue la requête).
  • forwarded_for (String) — En-tête HTTP X-Forwarded-For transmis dans la requête HTTP.
  • quota_key (String) — « Clé de quota » spécifiée dans le paramètre quotas.
  • distributed_depth (UInt64) — Nombre de fois qu’une query a été relayée entre les serveurs.
  • revision (UInt32) — Révision de ClickHouse.
  • ProfileEvents (Map(LowCardinality(String), UInt64)) — Les ProfileEvents qui mesurent différentes métriques pour ce thread. Leur description est disponible dans la table system.events.
Alias :
  • ProfileEvents.Names — alias de mapKeys(ProfileEvents).
  • ProfileEvents.Values — alias de mapValues(ProfileEvents).

Exemple

 SELECT * FROM system.query_thread_log LIMIT 1 \G
Row 1:
──────
hostname:                      clickhouse.eu-central1.internal
event_date:                    2020-09-11
event_time:                    2020-09-11 10:08:17
event_time_microseconds:       2020-09-11 10:08:17.134042
query_start_time:              2020-09-11 10:08:17
query_start_time_microseconds: 2020-09-11 10:08:17.063150
query_duration_ms:             70
read_rows:                     0
read_bytes:                    0
written_rows:                  1
written_bytes:                 12
memory_usage:                  4300844
peak_memory_usage:             4300844
thread_name:                   TCPHandler
thread_id:                     638133
master_thread_id:              638133
query:                         INSERT INTO test1 VALUES
is_initial_query:              1
user:                          default
query_id:                      50a320fd-85a8-49b8-8761-98a86bcbacef
address:                       ::ffff:127.0.0.1
port:                          33452
initial_user:                  default
initial_query_id:              50a320fd-85a8-49b8-8761-98a86bcbacef
initial_address:               ::ffff:127.0.0.1
initial_port:                  33452
interface:                     1
os_user:                       bharatnc
client_hostname:               tower
client_name:                   ClickHouse
client_revision:               54437
client_version_major:          20
client_version_minor:          7
client_version_patch:          2
http_method:                   0
http_user_agent:
quota_key:
revision:                      54440
ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}

Voir aussi

  • system.query_log — Description de la table système query_log, qui contient des informations générales sur l’exécution des requêtes.
  • system.query_views_log — Cette table contient des informations sur chaque vue exécutée au cours d’une requête.
Dernière modification le 25 juin 2026