Skip to main content
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

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

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

Execute localmente todas as tarefas de um plano de consulta distribuída. Útil para testes e depuração.

distributed_plan_fallback_to_local_execution

Quando um plano de consulta contém uma etapa que não suporta execução distribuída, registra o motivo no log e executa a consulta no initiator, em vez de lançar uma exceção. Desabilite para obter uma exceção. Só tem efeito quando make_distributed_plan (private preview) está habilitado.

distributed_plan_force_exchange_kind

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

Use a estratégia de agregação Shuffle em vez de PartialAggregation + Merge no plano de consulta distribuída. Ignorado quando a estratégia Shuffle não pode produzir um resultado correto, por exemplo para GROUPING SETS ou quando a agregação deve produzir resultados em ordem de bucket.

distributed_plan_max_rows_to_broadcast

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

Remove exchanges desnecessários do plano de consulta distribuída. Desative esta opção para depuração.

distributed_plan_prefer_replicas_over_workers

Serializa o plano de consulta distribuída para execução nas réplicas.

distributed_plan_read_in_order

Permite a otimização de leitura ordenada (read-in-order) para ORDER BY em um plano de consulta distribuída, de modo que uma leitura ordenada pela chave de ordenação da tabela possa dispensar a ordenação e encerrar mais cedo, em vez de varrer e ordenar. Desativada por padrão: a reescrita que distribui uma ordenação parte do princípio de que a ordenação por ela encapsulada não depende de sua entrada já estar ordenada; porém, uma ordenação que dependa disso pode receber linhas por meio de um exchange que não preserva a ordem. Hoje, apenas as formas em que nenhum exchange permanece entre a leitura e a ordenação são seguras.

distributed_plan_workers_num

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

Tempo total de relógio, em milissegundos, que uma consulta pode gastar no provisionamento de workers sem estado antes da execução: reservando-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 reservados 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 reserva e verificação (sem novas tentativas).
Última modificação em 26 de setembro de 2026