system.scheduler 시스템 테이블

system.scheduler 는 로컬 서버에 존재하는 scheduling nodes 에 대한 정보와 상태를 담고 있어요. 모니터링에 사용할 수 있으며, 각 스케줄링 노드마다 하나의 행이 생성돼요.

출처: 문서

본문

ClickHouse Cloud에서의 조회 — 이 시스템 테이블의 데이터는 ClickHouse Cloud에서 각 노드에 로컬로 저장돼요. 따라서 모든 데이터의 완전한 뷰를 얻으려면 clusterAllReplicas 함수가 필요해요. 자세한 내용은 여기 를 참고하세요.

Description

로컬 서버에 존재하는 scheduling nodes 에 대한 정보와 상태를 포함해요. 이 테이블은 모니터링에 사용할 수 있어요. 각 스케줄링 노드마다 하나의 행이 들어 있어요.

Columns

resource (String) — 리소스 이름이에요.
path (String) — 이 리소스 스케줄링 계층 내에서 스케줄링 노드로 가는 경로예요.
type (String) — 스케줄링 노드의 유형이에요.
weight (Float64) — 노드의 가중치이며 fair 유형의 상위 노드가 사용해요.
priority (Int64) — 노드의 우선순위이며 ‘priority’ 유형의 상위 노드가 사용해요(값이 낮을수록 우선순위가 높아요).
precedence (Int64) — 노드의 실행 순위이며 공간 공유(space-shared, memory) 상위 노드가 접근 허용과 축출(eviction) 순서를 정할 때 사용해요(값이 낮을수록 실행 순위가 높아요).
is_active (Nullable(UInt8)) — 이 노드가 현재 활성 상태인지 여부 — 디큐(dequeue)할 리소스 요청이 있고 제약이 충족되었는지를 나타내요.
active_children (Nullable(UInt64)) — 활성 상태인 자식의 수예요.
dequeued_requests (Nullable(UInt64)) — 이 노드에서 디큐된 리소스 요청의 총 수예요.
canceled_requests (Nullable(UInt64)) — 이 노드에서 취소된 리소스 요청의 총 수예요.
rejected_requests (Nullable(UInt64)) — 이 노드에서 거부된 리소스 요청의 총 수예요.
dequeued_cost (Nullable(Int64)) — 이 노드에서 디큐된 모든 요청의 비용(예: 바이트 크기) 합계예요.
canceled_cost (Nullable(Int64)) — 이 노드에서 취소된 모든 요청의 비용(예: 바이트 크기) 합계예요.
rejected_cost (Nullable(Int64)) — 이 노드에서 거부된 모든 요청의 비용(예: 바이트 크기) 합계예요.
busy_periods (Nullable(UInt64)) — 이 노드의 비활성화 총 횟수예요.
throughput (Nullable(Float64)) — 현재 평균 처리량(초당 디큐된 비용)이에요.
vruntime (Nullable(Float64)) — fair 노드의 자식에만 해당돼요. SFQ 알고리즘이 max-min 공정 방식으로 처리할 다음 자식을 선택할 때 사용하는 노드의 가상 런타임이에요.
system_vruntime (Nullable(Float64)) — fair 노드에만 해당돼요. 마지막으로 처리된 리소스 요청의 vruntime 을 보여주는 가상 런타임이에요. 자식 활성화 시 vruntime 의 새 값으로 사용돼요.
queue_length (Nullable(UInt64)) — fifo 노드에만 해당돼요. 큐에 있는 리소스 요청의 현재 수예요.
queue_cost (Nullable(Int64)) — fifo 노드에만 해당돼요. 큐에 있는 모든 요청의 비용(예: 바이트 크기) 합계예요.
budget (Nullable(Int64)) — fifo 노드에만 해당돼요. 새 리소스 요청에 사용할 수 있는 ‘비용 단위’ 의 수예요. 리소스 요청의 예상 비용과 실제 비용이 불일치할 때(예: 읽기/쓰기 실패 후) 나타날 수 있어요.
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 노드에만 해당돼요. 토큰 버킷 스로틀러에서 현재 사용 가능한 토큰 수예요.
allocated (Nullable(Int64)) — 공간 공유(space-shared) 노드에만 해당돼요. 이 노드 아래에 현재 할당된 리소스 양이에요.
allocations (Nullable(UInt64)) — 공간 공유 노드에만 해당돼요. 이 노드 아래에서 현재 실행 중인 리소스 할당 수예요.
updates (Nullable(UInt64)) — 공간 공유 노드에만 해당돼요. 이 노드를 통해 전파된 업데이트 총 수예요.
increases (Nullable(UInt64)) — 공간 공유 노드에만 해당돼요. 이 노드가 승인한 증가 요청 총 수예요.
decreases (Nullable(UInt64)) — 공간 공유 노드에만 해당돼요. 이 노드가 승인한 감소 요청 총 수예요.
admits (Nullable(UInt64)) — 공간 공유 노드에만 해당돼요. 이 노드가 허용한 할당 총 수예요.
removes (Nullable(UInt64)) — 공간 공유 노드에만 해당돼요. 이 노드에서 제거된 할당 총 수예요.
killers (Nullable(UInt64)) — 공간 공유 노드에만 해당돼요. 이 노드가 증가 요청으로 인해 시작한 축출 총 횟수예요.
victims (Nullable(UInt64)) — 공간 공유 노드에만 해당돼요. 이 노드에서 축출된 할당 총 수예요.
rejects (Nullable(UInt64)) — allocation_queue 노드에만 해당돼요. 이 노드에서 거부된 리소스 할당 총 수예요.
pending (Nullable(UInt64)) — allocation_queue 노드에만 해당돼요. 이 노드에서 현재 대기 중인 리소스 할당 수예요.

Examples

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