> ## 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.

> Tabela do sistema que contém informações e o status dos nós de agendamento presentes no servidor local.

# system.scheduler

<Info>
  **Consultas no ClickHouse Cloud**

  Os dados nesta tabela de sistema são mantidos localmente em cada nó do ClickHouse Cloud. Portanto, para obter uma visão completa de todos os dados, é necessário usar a função `clusterAllReplicas`. Consulte [aqui](/pt-BR/reference/system-tables/overview#system-tables-in-clickhouse-cloud) para mais detalhes.
</Info>

<div id="description">
  ## Descrição
</div>

Contém informações e o status dos [nós de agendamento](/pt-BR/concepts/features/configuration/server-config/workload-scheduling#hierarchy) presentes no servidor local.
Esta tabela pode ser usada para monitoramento. A tabela contém uma linha para cada nó de agendamento.

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

* `resource` ([String](/pt-BR/reference/data-types/index)) — Nome do recurso
* `path` ([String](/pt-BR/reference/data-types/index)) — Caminho para um nó de agendamento dentro desta hierarquia de agendamento de recursos
* `type` ([String](/pt-BR/reference/data-types/index)) — Tipo de um nó de agendamento.
* `weight` ([Float64](/pt-BR/reference/data-types/index)) — Peso de um nó, usado por um nó pai do tipo `fair`.
* `priority` ([Int64](/pt-BR/reference/data-types/index)) — Prioridade de um nó, usada por um nó pai do tipo 'priority' (um valor menor significa prioridade mais alta).
* `is_active` ([UInt8](/pt-BR/reference/data-types/index)) — Indica se este nó está ativo no momento — se tem solicitações de recurso para serem removidas da fila e restrições atendidas.
* `active_children` ([UInt64](/pt-BR/reference/data-types/index)) — O número de filhos em estado ativo.
* `dequeued_requests` ([UInt64](/pt-BR/reference/data-types/index)) — O número total de solicitações de recurso removidas da fila deste nó.
* `canceled_requests` ([UInt64](/pt-BR/reference/data-types/index)) — O número total de solicitações de recurso canceladas deste nó.
* `dequeued_cost` ([Int64](/pt-BR/reference/data-types/index)) — A soma dos custos (por exemplo, tamanho em bytes) de todas as solicitações removidas da fila deste nó.
* `throughput` ([Float64](/pt-BR/reference/data-types/index)) — Taxa de transferência média atual (custo removido da fila por segundo).
* `canceled_cost` ([Int64](/pt-BR/reference/data-types/index)) — A soma dos custos (por exemplo, tamanho em bytes) de todas as solicitações canceladas deste nó.
* `busy_periods` ([UInt64](/pt-BR/reference/data-types/index)) — O número total de desativações deste nó.
* `vruntime` ([Nullable(Float64)](/pt-BR/reference/data-types/index)) — Apenas para filhos de nós `fair`. Tempo de execução virtual de um nó, usado pelo algoritmo SFQ para selecionar o próximo filho a ser processado de forma max-min justa.
* `system_vruntime` ([Nullable(Float64)](/pt-BR/reference/data-types/index)) — Apenas para nós `fair`. Tempo de execução virtual que mostra o `vruntime` da última solicitação de recurso processada. Usado durante a ativação do filho como o novo valor de `vruntime`.
* `queue_length` ([Nullable(UInt64)](/pt-BR/reference/data-types/index)) — Apenas para nós `fifo`. Número atual de solicitações de recurso presentes na fila.
* `queue_cost` ([Nullable(Int64)](/pt-BR/reference/data-types/index)) — Apenas para nós `fifo`. Soma dos custos (por exemplo, tamanho em bytes) de todas as solicitações presentes na fila.
* `budget` ([Nullable(Int64)](/pt-BR/reference/data-types/index)) — Apenas para nós `fifo`. O número de 'unidades de custo' disponíveis para novas solicitações de recurso. Pode aparecer em caso de discrepância entre os custos estimados e reais das solicitações de recurso (por exemplo, após falha de leitura/gravação)
* `is_satisfied` ([Nullable(UInt8)](/pt-BR/reference/data-types/index)) — Apenas para nós de restrição (por exemplo, `inflight_limit`). Igual a `1` se todas as restrições deste nó forem atendidas.
* `inflight_requests` ([Nullable(Int64)](/pt-BR/reference/data-types/index)) — Apenas para nós `inflight_limit`. O número de solicitações de recurso removidas da fila deste nó que estão atualmente em estado de consumo.
* `inflight_cost` ([Nullable(Int64)](/pt-BR/reference/data-types/index)) — Apenas para nós `inflight_limit`. A soma dos custos (por exemplo, bytes) de todas as solicitações de recurso removidas da fila deste nó que estão atualmente em estado de consumo.
* `max_requests` ([Nullable(Int64)](/pt-BR/reference/data-types/index)) — Apenas para nós `inflight_limit`. Limite superior para inflight\_requests que leva à violação da restrição.
* `max_cost` ([Nullable(Int64)](/pt-BR/reference/data-types/index)) — Apenas para nós `inflight_limit`. Limite superior para inflight\_cost que leva à violação da restrição.
* `max_speed` ([Nullable(Float64)](/pt-BR/reference/data-types/index)) — Apenas para nós `bandwidth_limit`. Limite superior de largura de banda em tokens por segundo.
* `max_burst` ([Nullable(Float64)](/pt-BR/reference/data-types/index)) — Apenas para nós `bandwidth_limit`. Limite superior de tokens disponíveis no limitador token-bucket.
* `throttling_us` ([Nullable(Int64)](/pt-BR/reference/data-types/index)) — Apenas para nós `bandwidth_limit`. Número total de microssegundos em que este nó esteve em estado de limitação.
* `tokens` ([Nullable(Float64)](/pt-BR/reference/data-types/index)) — Apenas para nós `bandwidth_limit`. Número de tokens disponíveis atualmente no limitador token-bucket.

Exemplo:

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