Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.processes

View as MarkdownEdit this pageReport an issueSet up docs MCP

Описание

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

Столбцы

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

Псевдонимы:

  • ProfileEvents.Names — Псевдоним mapKeys(ProfileEvents).
  • ProfileEvents.Values — Псевдоним mapValues(ProfileEvents).
  • Settings.Names — Псевдоним mapKeys(Settings).
  • Settings.Values — Псевдоним 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.
Navigation