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

Cette table système sert à implémenter la requête SHOW PROCESSLIST.

Colonnes

  • is_initial_query (UInt8) — Indique si cette requête provient directement de l’utilisateur ou si elle a été émise par le serveur ClickHouse dans le cadre de l’exécution de requêtes distribuées.
  • user (String) — L’utilisateur ayant exécuté la requête. Gardez à l’esprit qu’en traitement distribué, les requêtes sont envoyées aux serveurs distants sous l’utilisateur default. Ce champ contient le nom d’utilisateur de la requête concernée, et non celui de la requête qu’elle a initiée.
  • query_id (String) — ID de la requête, s’il est défini.
  • address (IPv6) — L’adresse IP depuis laquelle la requête a été effectuée. Il en va de même pour le traitement distribué. Pour déterminer l’origine d’une requête distribuée, consultez system.processes sur le serveur à l’origine de la requête.
  • port (UInt16) — Le port client depuis lequel la requête a été effectuée.
  • initial_user (String) — Nom de l’utilisateur ayant exécuté la requête initiale (dans le cadre de l’exécution de requêtes distribuées).
  • initial_query_id (String) — ID de la requête initiale (dans le cadre de l’exécution de requêtes distribuées).
  • 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.
  • interface (UInt8) — Interface utilisée pour envoyer la requête. TCP = 1, HTTP = 2, GRPC = 3, MYSQL = 4, POSTGRESQL = 5, LOCAL = 6, TCP_INTERSERVER = 7.
  • os_user (String) — Nom d’utilisateur du système d’exploitation qui exécute clickhouse-client.
  • client_hostname (String) — Nom d’hôte de la machine cliente sur laquelle clickhouse-client ou un autre client TCP est exécuté.
  • client_name (String) — Nom de clickhouse-client ou d’un autre client TCP.
  • client_agent (LowCardinality(String)) — L’agent de codage IA qui a invoqué le client (par exemple claude-code, cursor), détecté à partir des variables d’environnement. Vide si aucun agent n’a été détecté.
  • client_revision (UInt64) — Révision de clickhouse-client ou d’un autre client TCP.
  • client_version_major (UInt64) — Version majeure de clickhouse-client ou d’un autre client TCP.
  • client_version_minor (UInt64) — Version mineure de clickhouse-client ou d’un autre client TCP.
  • client_version_patch (UInt64) — Composant de correctif de la version de clickhouse-client ou d’un autre client TCP.
  • http_method (UInt8) — Méthode HTTP à l’origine de 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 (String) — En-tête HTTP 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 à l’origine de 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 (voir keyed).
  • distributed_depth (UInt64) — Nombre de fois que la requête a été retransmise en interne entre les nœuds du serveur.
  • elapsed (Float64) — Temps écoulé, en secondes, depuis le début de l’exécution de la requête.
  • is_cancelled (UInt8) — Indique si la requête a été annulée.
  • is_all_data_sent (UInt8) — Indique si toutes les données ont été envoyées au client (autrement dit, si la requête était terminée sur le serveur).
  • read_rows (UInt64) — Nombre de lignes lues depuis la table. En traitement distribué, sur le serveur demandeur, il s’agit du total de tous les serveurs distants.
  • read_bytes (UInt64) — Nombre d’octets non compressés lus depuis la table. En traitement distribué, sur le serveur demandeur, il s’agit du total de tous les serveurs distants.
  • total_rows_approx (UInt64) — Estimation du nombre total de lignes à lire. En traitement distribué, sur le serveur demandeur, il s’agit du total de tous les serveurs distants. Cette valeur peut être mise à jour pendant le traitement de la requête, lorsque de nouvelles sources à traiter sont identifiées.
  • written_rows (UInt64) — Nombre de lignes écrites dans le stockage.
  • written_bytes (UInt64) — Nombre d’octets écrits dans le stockage.
  • memory_usage (Int64) — Quantité de RAM utilisée par la requête. Il se peut qu’elle n’inclue pas certains types de mémoire dédiée.
  • peak_memory_usage (Int64) — Pic actuel d’utilisation de la mémoire.
  • query (String) — Texte de la requête. Pour INSERT, il n’inclut pas les données à insérer.
  • normalized_query_hash (UInt64) — Valeur de hachage numérique, identique par exemple pour des requêtes qui ne diffèrent que par les valeurs des littéraux.
  • query_kind (String) — Type de requête - SELECT, INSERT, etc.
  • thread_ids (Array(UInt64)) — Liste des identifiants de tous les threads ayant participé à cette requête.
  • peak_threads_usage (UInt64) — Nombre maximal de threads exécutant simultanément la requête.
  • ProfileEvents (Map(LowCardinality(String), UInt64)) — ProfileEvents calculés pour cette requête.
  • Settings (Map(LowCardinality(String), LowCardinality(String))) — Liste des user-level settings modifiés.
  • current_database (String) — Nom de la base de données actuelle.
  • is_internal (UInt8) — Indique s’il s’agit d’une requête auxiliaire exécutée en interne.
SELECT * FROM system.processes LIMIT 10 FORMAT Vertical;
Row 1:
──────
is_initial_query:     1
user:                 default
query_id:             35a360fa-3743-441d-8e1f-228c938268da
address:              ::ffff:172.23.0.1
port:                 47588
initial_user:         default
initial_query_id:     35a360fa-3743-441d-8e1f-228c938268da
initial_address:      ::ffff:172.23.0.1
initial_port:         47588
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:
elapsed:              0.000582537
is_cancelled:         0
is_all_data_sent:     0
read_rows:            0
read_bytes:           0
total_rows_approx:    0
written_rows:         0
written_bytes:        0
memory_usage:         0
peak_memory_usage:    0
query:                SELECT * from system.processes LIMIT 10 FORMAT Vertical;
thread_ids:           [67]
ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}
Settings:             {'background_pool_size':'32','load_balancing':'random','allow_suspicious_low_cardinality_types':'1','distributed_aggregation_memory_efficient':'1','skip_unavailable_shards':'1','log_queries':'1','max_bytes_before_external_group_by':'20000000000','max_bytes_before_external_sort':'20000000000','allow_introspection_functions':'1'}

1 rows in set. Elapsed: 0.002 sec.
Dernière modification le 25 juin 2026