> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Системная таблица, содержащая информацию о размещённых на локальном сервере узлах планировщика и их статусе.

# system.scheduler

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

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

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

Содержит информацию о [узлах планировщика](/ru/concepts/features/configuration/server-config/workload-scheduling#hierarchy), находящихся на локальном сервере, и их статусе.
Эту таблицу можно использовать для мониторинга. Таблица содержит по одной строке для каждого узла планировщика.

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

* `resource` ([String](/ru/reference/data-types/index)) — Имя ресурса
* `path` ([String](/ru/reference/data-types/index)) — Путь к узлу планировщика в этой иерархии планирования ресурсов
* `type` ([String](/ru/reference/data-types/index)) — Тип узла планировщика.
* `weight` ([Float64](/ru/reference/data-types/index)) — Вес узла, используемый родительским узлом типа `fair`.
* `priority` ([Int64](/ru/reference/data-types/index)) — Приоритет узла, используемый родительским узлом типа 'priority' (меньшее значение означает более высокий приоритет).
* `is_active` ([UInt8](/ru/reference/data-types/index)) — Указывает, активен ли этот узел в данный момент — есть ли у него запросы ресурсов, ожидающие извлечения из очереди, и удовлетворены ли ограничения.
* `active_children` ([UInt64](/ru/reference/data-types/index)) — Количество дочерних узлов в активном состоянии.
* `dequeued_requests` ([UInt64](/ru/reference/data-types/index)) — Общее количество запросов ресурсов, извлечённых из очереди этого узла.
* `canceled_requests` ([UInt64](/ru/reference/data-types/index)) — Общее количество запросов ресурсов, отменённых для этого узла.
* `dequeued_cost` ([Int64](/ru/reference/data-types/index)) — Сумма стоимостей (например, размера в байтах) всех запросов, извлечённых из очереди этого узла.
* `throughput` ([Float64](/ru/reference/data-types/index)) — Текущая средняя пропускная способность (стоимость запросов, извлечённых из очереди, в секунду).
* `canceled_cost` ([Int64](/ru/reference/data-types/index)) — Сумма стоимостей (например, размера в байтах) всех запросов, отменённых для этого узла.
* `busy_periods` ([UInt64](/ru/reference/data-types/index)) — Общее количество деактиваций этого узла.
* `vruntime` ([Nullable(Float64)](/ru/reference/data-types/index)) — Только для дочерних узлов `fair`. Виртуальное время выполнения узла, используемое алгоритмом SFQ для выбора следующего дочернего узла для обработки по принципу max-min fairness.
* `system_vruntime` ([Nullable(Float64)](/ru/reference/data-types/index)) — Только для узлов `fair`. Виртуальное время выполнения, показывающее `vruntime` последнего обработанного запроса ресурсов. Используется при активации дочернего узла как новое значение `vruntime`.
* `queue_length` ([Nullable(UInt64)](/ru/reference/data-types/index)) — Только для узлов `fifo`. Текущее количество запросов ресурсов в очереди.
* `queue_cost` ([Nullable(Int64)](/ru/reference/data-types/index)) — Только для узлов `fifo`. Сумма стоимостей (например, размера в байтах) всех запросов, находящихся в очереди.
* `budget` ([Nullable(Int64)](/ru/reference/data-types/index)) — Только для узлов `fifo`. Количество доступных 'единиц стоимости' для новых запросов ресурсов. Может появляться в случае расхождения между оценочной и фактической стоимостью запросов ресурсов (например, после сбоя чтения/записи)
* `is_satisfied` ([Nullable(UInt8)](/ru/reference/data-types/index)) — Только для узлов-ограничений (например, `inflight_limit`). Равно `1`, если все ограничения этого узла соблюдены.
* `inflight_requests` ([Nullable(Int64)](/ru/reference/data-types/index)) — Только для узлов `inflight_limit`. Количество запросов ресурсов, извлечённых из очереди этого узла и находящихся в данный момент в состоянии обработки.
* `inflight_cost` ([Nullable(Int64)](/ru/reference/data-types/index)) — Только для узлов `inflight_limit`. Сумма стоимостей (например, байтов) всех запросов ресурсов, извлечённых из очереди этого узла и находящихся в данный момент в состоянии обработки.
* `max_requests` ([Nullable(Int64)](/ru/reference/data-types/index)) — Только для узлов `inflight_limit`. Верхний предел для inflight\_requests, при превышении которого нарушается ограничение.
* `max_cost` ([Nullable(Int64)](/ru/reference/data-types/index)) — Только для узлов `inflight_limit`. Верхний предел для inflight\_cost, при превышении которого нарушается ограничение.
* `max_speed` ([Nullable(Float64)](/ru/reference/data-types/index)) — Только для узлов `bandwidth_limit`. Верхний предел пропускной способности в токенах в секунду.
* `max_burst` ([Nullable(Float64)](/ru/reference/data-types/index)) — Только для узлов `bandwidth_limit`. Верхний предел количества токенов, доступных в throttler token-bucket.
* `throttling_us` ([Nullable(Int64)](/ru/reference/data-types/index)) — Только для узлов `bandwidth_limit`. Общее количество микросекунд, в течение которых этот узел находился в состоянии throttling.
* `tokens` ([Nullable(Float64)](/ru/reference/data-types/index)) — Только для узлов `bandwidth_limit`. Количество токенов, доступных в данный момент в throttler token-bucket.

Пример:

```sql theme={null}
SELECT *
FROM system.scheduler
WHERE resource = 'network_read' AND path = '/prio/fair/prod'
FORMAT Vertical
```

```text theme={null}
Row 1:
──────
resource:          network_read
path:              /prio/fair/prod
type:              fifo
weight:            5
priority:          0
is_active:         0
active_children:   0
dequeued_requests: 67
canceled_requests: 0
dequeued_cost:     4692272
canceled_cost:     0
busy_periods:      63
vruntime:          938454.1999999989
system_vruntime:   ᴺᵁᴸᴸ
queue_length:      0
queue_cost:        0
budget:            -60524
is_satisfied:      ᴺᵁᴸᴸ
inflight_requests: ᴺᵁᴸᴸ
inflight_cost:     ᴺᵁᴸᴸ
max_requests:      ᴺᵁᴸᴸ
max_cost:          ᴺᵁᴸᴸ
max_speed:         ᴺᵁᴸᴸ
max_burst:         ᴺᵁᴸᴸ
throttling_us:     ᴺᵁᴸᴸ
tokens:            ᴺᵁᴸᴸ
```
