> ## 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` 関数を使用する必要があります。詳細については、[こちら](/ja/reference/system-tables/overview#system-tables-in-clickhouse-cloud)を参照してください。
</Info>

<div id="description">
  ## 説明
</div>

ローカルサーバー上に存在する[スケジューリングノード](/ja/concepts/features/configuration/server-config/workload-scheduling#hierarchy)に関する情報と状態を含みます。
このテーブルは監視に利用できます。各 スケジューリングノード につき1行が含まれます。

<div id="columns">
  ## カラム
</div>

* `resource` ([String](/ja/reference/data-types/index)) — リソース名
* `path` ([String](/ja/reference/data-types/index)) — このリソーススケジューリング階層内にあるスケジューリングノードへのパス
* `type` ([String](/ja/reference/data-types/index)) — スケジューリングノードの種類。
* `weight` ([Float64](/ja/reference/data-types/index)) — ノードの重み。`fair` 型の親ノードで使用されます。
* `priority` ([Int64](/ja/reference/data-types/index)) — ノードの優先度。'priority' 型の親ノードで使用されます (値が小さいほど優先度が高くなります) 。
* `is_active` ([UInt8](/ja/reference/data-types/index)) — このノードが現在アクティブかどうか。つまり、デキュー待ちのリソース要求があり、制約が満たされている状態です。
* `active_children` ([UInt64](/ja/reference/data-types/index)) — アクティブ状態の子ノードの数。
* `dequeued_requests` ([UInt64](/ja/reference/data-types/index)) — このノードからデキューされたリソース要求の合計数。
* `canceled_requests` ([UInt64](/ja/reference/data-types/index)) — このノードからキャンセルされたリソース要求の合計数。
* `dequeued_cost` ([Int64](/ja/reference/data-types/index)) — このノードからデキューされたすべての要求のコスト (例: バイト単位のサイズ) の合計。
* `throughput` ([Float64](/ja/reference/data-types/index)) — 現在の平均スループット (1 秒あたりのデキュー済みコスト) 。
* `canceled_cost` ([Int64](/ja/reference/data-types/index)) — このノードからキャンセルされたすべての要求のコスト (例: バイト単位のサイズ) の合計。
* `busy_periods` ([UInt64](/ja/reference/data-types/index)) — このノードが非アクティブ化された合計回数。
* `vruntime` ([Nullable(Float64)](/ja/reference/data-types/index)) — `fair` ノードの子ノードにのみ適用されます。SFQ アルゴリズムが max-min fair 方式で次に処理する子ノードを選択するために使用する、ノードの仮想ランタイムです。
* `system_vruntime` ([Nullable(Float64)](/ja/reference/data-types/index)) — `fair` ノードにのみ適用されます。最後に処理されたリソース要求の `vruntime` を示す仮想ランタイムです。子ノードのアクティブ化時に `vruntime` の新しい値として使用されます。
* `queue_length` ([Nullable(UInt64)](/ja/reference/data-types/index)) — `fifo` ノードにのみ適用されます。現在キュー内にあるリソース要求の数。
* `queue_cost` ([Nullable(Int64)](/ja/reference/data-types/index)) — `fifo` ノードにのみ適用されます。現在キュー内にあるすべての要求のコスト (例: バイト単位のサイズ) の合計。
* `budget` ([Nullable(Int64)](/ja/reference/data-types/index)) — `fifo` ノードにのみ適用されます。新しいリソース要求に利用可能な 'cost units' の数。リソース要求の見積もりコストと実際のコストに差異がある場合 (例: 読み取り/書き込みの失敗後) に現れることがあります。
* `is_satisfied` ([Nullable(UInt8)](/ja/reference/data-types/index)) — 制約ノード (例: `inflight_limit`) にのみ適用されます。このノードのすべての制約が満たされている場合は `1` になります。
* `inflight_requests` ([Nullable(Int64)](/ja/reference/data-types/index)) — `inflight_limit` ノードにのみ適用されます。このノードからデキューされ、現在消費中の状態にあるリソース要求の数。
* `inflight_cost` ([Nullable(Int64)](/ja/reference/data-types/index)) — `inflight_limit` ノードにのみ適用されます。このノードからデキューされ、現在消費中の状態にあるすべてのリソース要求のコスト (例: バイト数) の合計。
* `max_requests` ([Nullable(Int64)](/ja/reference/data-types/index)) — `inflight_limit` ノードにのみ適用されます。制約違反につながる inflight\_requests の上限。
* `max_cost` ([Nullable(Int64)](/ja/reference/data-types/index)) — `inflight_limit` ノードにのみ適用されます。制約違反につながる inflight\_cost の上限。
* `max_speed` ([Nullable(Float64)](/ja/reference/data-types/index)) — `bandwidth_limit` ノードにのみ適用されます。1 秒あたりのトークン数で表した帯域幅の上限。
* `max_burst` ([Nullable(Float64)](/ja/reference/data-types/index)) — `bandwidth_limit` ノードにのみ適用されます。トークンバケットスロットラーで利用可能なトークン数の上限。
* `throttling_us` ([Nullable(Int64)](/ja/reference/data-types/index)) — `bandwidth_limit` ノードにのみ適用されます。このノードがスロットリング状態にあった時間の合計 (マイクロ秒) 。
* `tokens` ([Nullable(Float64)](/ja/reference/data-types/index)) — `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:            ᴺᵁᴸᴸ
```