configurações de sessão skip_unavailable_shards_*

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

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.

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.