Essas configurações estão disponíveis em system.settings e são geradas automaticamente com base no código-fonte.
distributed_plan_default_reader_bucket_count
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.5 | 8 | Nova configuração experimental. |
Número padrão de tarefas para leitura paralela em consulta distribuída. As tarefas são distribuídas entre as réplicas. Usada pelo planejador distribuído baseado em regras. O otimizador baseado em custo define o fan-out da leitura com base no custo estimado e não usa esta configuração.
distributed_plan_default_shuffle_join_bucket_count
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.5 | 8 | Nova configuração experimental. |
Número padrão de buckets para shuffle-hash-join distribuído. Usado pelo planejador distribuído baseado em regras. O otimizador baseado em custo escolhe o fan-out com base no custo estimado e não usa essa configuração.
distributed_plan_execute_locally
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.5 | 0 | Nova configuração experimental. |
Execute localmente todas as tarefas de um plano de consulta distribuída. Útil para testes e depuração.
distributed_plan_force_exchange_kind
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.5 | Nova configuração experimental. |
Força o tipo especificado de operadores Exchange entre os estágios de uma consulta distribuída.
Valores possíveis:
- '' - não força nenhum tipo de operador Exchange; deixa o otimizador escolher,
- 'Persisted' - usa arquivos temporários no armazenamento de objetos,
- 'Streaming' - transmite dados de exchange pela rede.
distributed_plan_force_shuffle_aggregation
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.7 | 0 | Nova configuração experimental |
Use a estratégia de agregação Shuffle em vez de PartialAggregation + Merge no plano de consulta distribuída.
distributed_plan_max_rows_to_broadcast
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.7 | 20000 | Nova configuração experimental. |
Número máximo de linhas para usar broadcast join em vez de shuffle join no plano de consulta distribuída. Uma heurística para o planejador distribuído baseado em regras. Quando o otimizador baseado em custo está habilitado, a escolha entre broadcast e shuffle é feita com base no custo estimado, e esta configuração não tem efeito.
distributed_plan_optimize_exchanges
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.5 | 1 | Nova configuração experimental. |
Remove exchanges desnecessários do plano de consulta distribuída. Desative esta opção para depuração.
distributed_plan_prefer_replicas_over_workers
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.4 | 0 | Nova configuração para serializar o plano distribuído para execução nas réplicas |
Serializa o plano de consulta distribuída para execução nas réplicas.
distributed_plan_workers_num
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.6 | 0 | Nova configuração experimental para definir quantos workers sem estado devem ser reservados para uma consulta distribuída. Zero desabilita a reserva. |
Quantos workers sem estado serão usados para executar esta consulta. Zero desabilita a reserva de workers sem estado para planos distribuídos.
distributed_plan_workers_provisioning_timeout_ms
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.9 | 10000 | Nova configuração que limita por quanto tempo uma consulta aguarda que workers sem estado alugados se tornem acessíveis antes da execução; `compatibility` abaixo de 26.9 restaura o comportamento anterior, sem espera. |
Tempo total de relógio, em milissegundos, que uma consulta pode gastar no provisionamento de workers sem estado antes da execução: alugando-os do serviço de descoberta e verificando se estão acessíveis. A consulta bloqueia por até esse período para que os workers alugados fiquem prontos; quando esse tempo se esgota, a consulta prossegue com os workers verificados até então ou falha se nenhum estiver disponível. Zero aguarda apenas a etapa inicial de aluguel e verificação (sem novas tentativas).