跳转到主要内容
在 ClickHouse Cloud 中查询此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此,如需查看所有数据的完整情况,需要使用 clusterAllReplicas 函数。更多详情请参见此处

描述

包含驻留在本地服务器上的调度节点的相关信息和状态。 此表可用于监控。表中每个调度节点对应一行。

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