> ## 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 utilisée pour implémenter la requête `SHOW PROCESSLIST`.

# system.processes

<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>

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

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

* `is_initial_query` ([UInt8](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — ID de la requête, s’il est défini.
* `address` ([IPv6](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — Le port client depuis lequel la requête a été effectuée.
* `initial_user` ([String](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — ID de la requête initiale (dans le cadre de l’exécution de requêtes distribuées).
* `initial_address` ([IPv6](/fr/reference/data-types/index)) — Adresse IP depuis laquelle la requête parente a été lancée.
* `initial_port` ([UInt16](/fr/reference/data-types/index)) — Port client utilisé pour effectuer la requête parente.
* `interface` ([UInt8](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — Nom d’utilisateur du système d’exploitation qui exécute clickhouse-client.
* `client_hostname` ([String](/fr/reference/data-types/index)) — Nom d’hôte de la machine cliente sur laquelle clickhouse-client ou un autre client TCP est exécuté.
* `client_name` ([String](/fr/reference/data-types/index)) — Nom de clickhouse-client ou d’un autre client TCP.
* `client_agent` ([LowCardinality(String)](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — Révision de clickhouse-client ou d’un autre client TCP.
* `client_version_major` ([UInt64](/fr/reference/data-types/index)) — Version majeure de clickhouse-client ou d’un autre client TCP.
* `client_version_minor` ([UInt64](/fr/reference/data-types/index)) — Version mineure de clickhouse-client ou d’un autre client TCP.
* `client_version_patch` ([UInt64](/fr/reference/data-types/index)) — Composant de correctif de la version de clickhouse-client ou d’un autre client TCP.
* `http_method` ([UInt8](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — En-tête HTTP UserAgent transmis dans la requête HTTP.
* `http_referer` ([String](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — En-tête HTTP X-Forwarded-For transmis dans la requête HTTP.
* `quota_key` ([String](/fr/reference/data-types/index)) — Clé de quota spécifiée dans le paramètre quotas (voir keyed).
* `distributed_depth` ([UInt64](/fr/reference/data-types/index)) — Nombre de fois que la requête a été retransmise en interne entre les nœuds du serveur.
* `elapsed` ([Float64](/fr/reference/data-types/index)) — Temps écoulé, en secondes, depuis le début de l’exécution de la requête.
* `is_cancelled` ([UInt8](/fr/reference/data-types/index)) — Indique si la requête a été annulée.
* `is_all_data_sent` ([UInt8](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — Nombre de lignes écrites dans le stockage.
* `written_bytes` ([UInt64](/fr/reference/data-types/index)) — Nombre d’octets écrits dans le stockage.
* `memory_usage` ([Int64](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — Pic actuel d’utilisation de la mémoire.
* `query` ([String](/fr/reference/data-types/index)) — Texte de la requête. Pour INSERT, il n’inclut pas les données à insérer.
* `normalized_query_hash` ([UInt64](/fr/reference/data-types/index)) — 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](/fr/reference/data-types/index)) — Type de requête - SELECT, INSERT, etc.
* `thread_ids` ([Array(UInt64)](/fr/reference/data-types/index)) — Liste des identifiants de tous les threads ayant participé à cette requête.
* `peak_threads_usage` ([UInt64](/fr/reference/data-types/index)) — Nombre maximal de threads exécutant simultanément la requête.
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/fr/reference/data-types/index)) — ProfileEvents calculés pour cette requête.
* `Settings` ([Map(LowCardinality(String), LowCardinality(String))](/fr/reference/data-types/index)) — Liste des user-level settings modifiés.
* `current_database` ([String](/fr/reference/data-types/index)) — Nom de la base de données actuelle.
* `is_internal` ([UInt8](/fr/reference/data-types/index)) — Indique s’il s’agit d’une requête auxiliaire exécutée en interne.

```sql theme={null}
SELECT * FROM system.processes LIMIT 10 FORMAT Vertical;
```

```response theme={null}
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.
```
