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