> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Системная таблица для реализации запроса `SHOW PROCESSLIST`.

# system.processes

<Info>
  **Запросы в ClickHouse Cloud**

  Данные в этой системной таблице хранятся локально на каждом узле ClickHouse Cloud. Поэтому, чтобы получить полное представление обо всех данных, требуется функция `clusterAllReplicas`. Дополнительные сведения см. [здесь](/docs/ru/reference/system-tables/overview#system-tables-in-clickhouse-cloud).
</Info>

<div id="description">
  ## Описание
</div>

Эта системная таблица используется для выполнения запроса `SHOW PROCESSLIST`.

<div id="columns">
  ## Столбцы
</div>

* `is_initial_query` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Указывает, является ли запрос исходным. Возможные значения: 1 — исходный (верхнего уровня) запрос, 0 — дочерний запрос, инициированный другим запросом, включая запросы для распределённого выполнения и внутренние подзапросы.
* `user` ([String](/docs/ru/reference/data-types/string)) — Пользователь, выполнивший запрос. Учтите, что при распределённой обработке запросы отправляются на удалённые серверы от имени пользователя `default`. Это поле содержит имя пользователя для конкретного запроса, а не для исходного запроса, инициировавшего этот запрос.
* `query_id` ([String](/docs/ru/reference/data-types/string)) — ID запроса, если задан.
* `address` ([IPv6](/docs/ru/reference/data-types/ipv6)) — IP-адрес, с которого был выполнен запрос. То же относится к распределённой обработке. Чтобы определить, откуда изначально был выполнен распределённый запрос, просмотрите system.processes на сервере, инициировавшем запрос.
* `port` ([UInt16](/docs/ru/reference/data-types/int-uint)) — Порт клиента, с которого был выполнен запрос.
* `initial_user` ([String](/docs/ru/reference/data-types/string)) — Имя пользователя, выполнившего исходный запрос в той же цепочке запросов.
* `initial_query_id` ([String](/docs/ru/reference/data-types/string)) — ID исходного запроса в той же цепочке запросов.
* `initial_address` ([IPv6](/docs/ru/reference/data-types/ipv6)) — IP-адрес, с которого был запущен исходный запрос в той же цепочке запросов.
* `initial_port` ([UInt16](/docs/ru/reference/data-types/int-uint)) — Порт клиента, с которого был запущен исходный запрос в той же цепочке запросов.
* `interface` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Интерфейс, использованный для отправки запроса. TCP = 1, HTTP = 2, GRPC = 3, MYSQL = 4, POSTGRESQL = 5, LOCAL = 6, TCP\_INTERSERVER = 7.
* `os_user` ([String](/docs/ru/reference/data-types/string)) — Имя пользователя операционной системы, запускающего clickhouse-client.
* `client_hostname` ([String](/docs/ru/reference/data-types/string)) — Имя хоста клиентской машины, на которой запущен clickhouse-client или другой TCP-клиент.
* `client_name` ([String](/docs/ru/reference/data-types/string)) — Имя clickhouse-client или другого TCP-клиента.
* `client_agent` ([LowCardinality(String)](/docs/ru/reference/data-types/lowcardinality)) — ИИ-агент для написания кода, вызвавший клиент (например, `claude-code`, `cursor`), определённый по переменным окружения. Пусто, если агент не обнаружен.
* `client_revision` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Ревизия clickhouse-client или другого TCP-клиента.
* `client_version_major` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Мажорная версия clickhouse-client или другого TCP-клиента.
* `client_version_minor` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Минорная версия clickhouse-client или другого TCP-клиента.
* `client_version_patch` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Компонент патча версии clickhouse-client или другого TCP-клиента.
* `http_method` ([UInt8](/docs/ru/reference/data-types/int-uint)) — HTTP-метод, инициировавший запрос. Возможные значения: 0 - запрос был запущен через интерфейс TCP, 1 - использовался метод GET, 2 - использовался метод POST, 4 - использовался метод PUT, 5 - использовался метод DELETE, 6 - использовался метод HEAD.
* `http_user_agent` ([String](/docs/ru/reference/data-types/string)) — HTTP-заголовок UserAgent, переданный в HTTP-запросе.
* `http_referer` ([String](/docs/ru/reference/data-types/string)) — HTTP-заголовок Referer, переданный в HTTP-запросе (содержит полный или частичный адрес страницы, выполнившей запрос).
* `forwarded_for` ([String](/docs/ru/reference/data-types/string)) — HTTP-заголовок X-Forwarded-For, переданный в HTTP-запросе.
* `quota_key` ([String](/docs/ru/reference/data-types/string)) — Ключ квоты, указанный в настройке quotas (см. keyed).
* `distributed_depth` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Количество внутренних перенаправлений запроса между серверными узлами.
* `elapsed` ([Float64](/docs/ru/reference/data-types/float)) — Время в секундах с начала выполнения запроса.
* `is_cancelled` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Был ли запрос отменён.
* `is_all_data_sent` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Были ли все данные отправлены клиенту (то есть завершилось ли выполнение запроса на сервере).
* `read_rows` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Количество строк, прочитанных из таблицы. При распределённой обработке на запрашивающем сервере это общее значение для всех удалённых серверов.
* `read_bytes` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Количество несжатых байтов, прочитанных из таблицы. При распределённой обработке на запрашивающем сервере это общее значение для всех удалённых серверов.
* `total_rows_approx` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Приблизительное общее количество строк, которые необходимо прочитать. При распределённой обработке на запрашивающем сервере это общее значение для всех удалённых серверов. Может обновляться в ходе обработки запроса по мере обнаружения новых источников данных.
* `written_rows` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Количество строк, записанных в хранилище.
* `written_bytes` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Количество байтов, записанных в хранилище.
* `memory_usage` ([Int64](/docs/ru/reference/data-types/int-uint)) — Объём оперативной памяти, используемой запросом. Может не включать некоторые типы выделенной памяти.
* `peak_memory_usage` ([Int64](/docs/ru/reference/data-types/int-uint)) — Текущее пиковое использование памяти.
* `query` ([String](/docs/ru/reference/data-types/string)) — Текст запроса. Для INSERT не включает вставляемые данные.
* `normalized_query_hash` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Числовое хеш-значение, одинаковое, например, для запросов, различающихся только значениями литералов.
* `query_kind` ([String](/docs/ru/reference/data-types/string)) — Тип запроса — SELECT, INSERT и т. д.
* `thread_ids` ([Array(UInt64)](/docs/ru/reference/data-types/array)) — Список идентификаторов всех потоков, участвовавших в выполнении этого запроса.
* `peak_threads_usage` ([UInt64](/docs/ru/reference/data-types/int-uint)) — Максимальное количество потоков, одновременно выполнявших запрос.
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/docs/ru/reference/data-types/map)) — ProfileEvents, рассчитанные для этого запроса.
* `Settings` ([Map(LowCardinality(String), LowCardinality(String))](/docs/ru/reference/data-types/map)) — Список изменённых настроек на уровне пользователя.
* `current_database` ([String](/docs/ru/reference/data-types/string)) — Имя текущей базы данных.
* `is_internal` ([UInt8](/docs/ru/reference/data-types/int-uint)) — Указывает, является ли запрос вспомогательным и выполняется ли он внутренне.

**Псевдонимы:**

* `ProfileEvents.Names` — Псевдоним `mapKeys(ProfileEvents)`.
* `ProfileEvents.Values` — Псевдоним `mapValues(ProfileEvents)`.
* `Settings.Names` — Псевдоним `mapKeys(Settings)`.
* `Settings.Values` — Псевдоним `mapValues(Settings)`.

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