Skip to main content
Essas configurações estão disponíveis em system.settings e são autogeradas a partir do código-fonte.

skip_unavailable_shards

Ativa ou desativa a opção de ignorar silenciosamente shards indisponíveis. O comportamento desta configuração é controlado pelo parâmetro skip_unavailable_shards_mode. Valores possíveis:
  • 1 — ignorar ativado. Se um shard estiver indisponível, o ClickHouse retorna um resultado com base em dados parciais e não relata problemas de disponibilidade do nó.
  • 0 — ignorar desativado. Se um shard estiver indisponível, o ClickHouse lança uma exceção.

skip_unavailable_shards_mode

Controla quais exceções de um shard remoto são ignoradas silenciosamente quando skip_unavailable_shards está habilitado. A configuração não tem efeito quando skip_unavailable_shards = 0. Valores possíveis:
  • unavailable — Apenas erros relacionados à conexão são ignorados. Um shard é considerado indisponível quando o ClickHouse não consegue se conectar a nenhuma de suas réplicas ou quando o hostname de uma réplica não pode ser resolvido via DNS.
  • unavailable_or_table_missing — Além de unavailable, erros causados pela ausência de uma tabela ou banco de dados no shard são ignorados. Isso é útil enquanto uma tabela está sendo criada ou removida em um cluster. Este é o valor padrão e corresponde ao comportamento histórico de skip_unavailable_shards, que também tratava como indisponível um shard cuja tabela não existe.
  • unavailable_or_exception_before_processing — Além de unavailable, qualquer exceção recebida de um shard antes de ele retornar qualquer bloco de dados ao iniciador é ignorada. Uma exceção que chega depois que o shard já retornou algum dado é sempre relançada. Observe que “antes de retornar qualquer dado” é verificado no iniciador: um shard que executa um cálculo bloqueante (por exemplo, uma agregação, ordenação ou LIMIT BY) pode processar linhas e falhar antes de emitir qualquer bloco; nesse caso, seu trabalho parcial é descartado silenciosamente, e a consulta retorna um resultado construído a partir dos shards restantes. Portanto, este é o modo mais permissivo e deve ser usado com cautela.
Última modificação em 23 de julho de 2026