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

> 包含本地服务器上调度节点的信息及其状态的系统表。

# system.scheduler

<Info>
  **在 ClickHouse Cloud 中查询**

  此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 `clusterAllReplicas` 函数。更多详情请参见[此处](/zh/reference/system-tables/overview#system-tables-in-clickhouse-cloud)。
</Info>

<div id="description">
  ## 描述
</div>

包含驻留在本地服务器上的[调度节点](/zh/concepts/features/configuration/server-config/workload-scheduling#hierarchy)的相关信息和状态。
此表可用于监控。表中每个调度节点对应一行。

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

* `resource` ([String](/zh/reference/data-types)) — 资源名称
* `path` ([String](/zh/reference/data-types)) — 此资源调度层级中某个调度节点的路径
* `type` ([String](/zh/reference/data-types)) — 调度节点的类型。
* `weight` ([Float64](/zh/reference/data-types)) — 节点的权重，由 `fair` 类型的父节点使用。
* `priority` ([Int64](/zh/reference/data-types)) — 节点的优先级，由 'priority' 类型的父节点使用 (值越小，优先级越高) 。
* `is_active` ([UInt8](/zh/reference/data-types)) — 此节点当前是否处于活动状态——即存在可出队的资源请求，且约束条件已满足。
* `active_children` ([UInt64](/zh/reference/data-types)) — 处于活动状态的子节点数量。
* `dequeued_requests` ([UInt64](/zh/reference/data-types)) — 从此节点出队的资源请求总数。
* `canceled_requests` ([UInt64](/zh/reference/data-types)) — 从此节点取消的资源请求总数。
* `dequeued_cost` ([Int64](/zh/reference/data-types)) — 从此节点出队的所有请求成本之和 (例如以字节为单位的大小) 。
* `throughput` ([Float64](/zh/reference/data-types)) — 当前平均吞吐量 (每秒出队的成本) 。
* `canceled_cost` ([Int64](/zh/reference/data-types)) — 从此节点取消的所有请求成本之和 (例如以字节为单位的大小) 。
* `busy_periods` ([UInt64](/zh/reference/data-types)) — 此节点失活的总次数。
* `vruntime` ([Nullable(Float64)](/zh/reference/data-types)) — 仅适用于 `fair` 节点的子节点。节点的虚拟运行时间，SFQ 算法使用它以最大-最小公平的方式选择下一个要处理的子节点。
* `system_vruntime` ([Nullable(Float64)](/zh/reference/data-types)) — 仅适用于 `fair` 节点。该虚拟运行时间表示最后一个已处理资源请求的 `vruntime`。在激活子节点时，用作 `vruntime` 的新值。
* `queue_length` ([Nullable(UInt64)](/zh/reference/data-types)) — 仅适用于 `fifo` 节点。当前驻留在队列中的资源请求数量。
* `queue_cost` ([Nullable(Int64)](/zh/reference/data-types)) — 仅适用于 fifo 节点。当前驻留在队列中的所有请求成本之和 (例如以字节为单位的大小) 。
* `budget` ([Nullable(Int64)](/zh/reference/data-types)) — 仅适用于 fifo 节点。新资源请求可用的 'cost units' 数量。当资源请求的估算成本与实际成本不一致时可能会出现这种情况 (例如在读/写失败后)
* `is_satisfied` ([Nullable(UInt8)](/zh/reference/data-types)) — 仅适用于约束节点 (例如 `inflight_limit`) 。如果此节点的所有约束都得到满足，则等于 `1`。
* `inflight_requests` ([Nullable(Int64)](/zh/reference/data-types)) — 仅适用于 `inflight_limit` 节点。从此节点出队且当前处于消费状态的资源请求数量。
* `inflight_cost` ([Nullable(Int64)](/zh/reference/data-types)) — 仅适用于 `inflight_limit` 节点。从此节点出队且当前处于消费状态的所有资源请求成本之和 (例如字节数) 。
* `max_requests` ([Nullable(Int64)](/zh/reference/data-types)) — 仅适用于 `inflight_limit` 节点。超过该 inflight\_requests 上限会导致约束违规。
* `max_cost` ([Nullable(Int64)](/zh/reference/data-types)) — 仅适用于 `inflight_limit` 节点。超过该 inflight\_cost 上限会导致约束违规。
* `max_speed` ([Nullable(Float64)](/zh/reference/data-types)) — 仅适用于 `bandwidth_limit` 节点。带宽上限，以每秒标记数表示。
* `max_burst` ([Nullable(Float64)](/zh/reference/data-types)) — 仅适用于 `bandwidth_limit` 节点。标记桶限流器中可用标记数的上限。
* `throttling_us` ([Nullable(Int64)](/zh/reference/data-types)) — 仅适用于 `bandwidth_limit` 节点。此节点处于限流状态的总微秒数。
* `tokens` ([Nullable(Float64)](/zh/reference/data-types)) — 仅适用于 `bandwidth_limit` 节点。标记桶限流器中当前可用的标记数量。

示例：

```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:            ᴺᵁᴸᴸ
```