system.processes

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

• is_initial_query (UInt8) — Indique si la requête est initiale. Valeurs possibles : 1 — une requête initiale (de niveau supérieur), 0 — une requête enfant initiée par une autre requête, y compris les requêtes destinées à une exécution distribuée et les sous-requêtes internes.
• user (String) — L’utilisateur qui a effectué la requête. Gardez à l’esprit que, dans le cadre du traitement distribué, les requêtes sont envoyées aux serveurs distants sous l’utilisateur default. Ce champ contient le nom d’utilisateur associé à une requête donnée, et non à la requête dont elle est issue.
• 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 connaître l’origine d’une requête distribuée, consultez system.processes sur le serveur ayant soumis la requête.
• port (UInt16) — Le port client depuis lequel la requête a été effectuée.
• initial_user (String) — Nom de l’utilisateur qui a exécuté la requête initiale dans la même chaîne de requêtes.
• initial_query_id (String) — ID de la requête initiale dans la même chaîne de requêtes.
• initial_address (IPv6) — Adresse IP depuis laquelle la requête initiale a été lancée dans la même chaîne de requêtes.
• initial_port (UInt16) — Port client depuis lequel la requête initiale a été lancée dans la même chaîne de requêtes.
• interface (UInt8) — L’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 exécutant 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 appelé 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 ayant initié 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, 4 - La méthode PUT a été utilisée, 5 - La méthode DELETE a été utilisée, 6 - La méthode HEAD a été utilisée.
• http_user_agent (String) — En-tête HTTP UserAgent transmis avec la requête HTTP.
• http_referer (String) — En-tête HTTP Referer transmis avec 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 avec la requête HTTP.
• quota_key (String) — La clé de quota spécifiée dans le paramètre quotas (voir keyed).
• distributed_depth (UInt64) — Nombre de fois où la requête a été retransmise en interne entre les nœuds de 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 s’est terminée sur le serveur).
• read_rows (UInt64) — Nombre de lignes lues dans 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 dans 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. Elle peut ne pas inclure 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 pour les 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 paramètres au niveau utilisateur modifiés.
• current_database (String) — Nom de la base de données courante.
• is_internal (UInt8) — Indique s’il s’agit d’une requête auxiliaire exécutée en interne.

Alias :

• ProfileEvents.Names — alias de mapKeys(ProfileEvents).
• ProfileEvents.Values — alias de mapValues(ProfileEvents).
• Settings.Names — alias de mapKeys(Settings).
• Settings.Values — alias de mapValues(Settings).

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.