ApsaraDB for ClickHouse:ZooKeeper management

Pré-requisitos

• O status do cluster é Running.

• Nenhuma cluster restart foi executada.

• Instâncias adquiridas após 13 de março de 2025, com versão 23,8 ou posterior, usam o ClickHouse Keeper, que utiliza ZXID de 64 bits. Nesse caso, não há risco de estouro do ZXID e a troca de líder é desnecessária.

  Importante

  Uma instância recém-adquirida refere-se a uma instância comprada pelo console. Isso não inclui instâncias criadas por restauração de backup, clonagem ou atualização de instâncias existentes.

Impacto no cluster

• Consultas: não afetadas.

• Operações de escrita:

  • Escritas em tabelas com o mecanismo ReplicatedMergeTree podem sofrer interrupções breves.

  • Se a suspensão de escrita estiver ativada, a instância bloqueia todas as operações de escrita após o início da troca. Durante esse período, qualquer tentativa de escrita na instância falhará.

• Operações DDL: a troca pode bloquear a execução de DDL distribuído.

• Duração:

  • Sem suspensão de escrita: aproximadamente 1 a 2 minutos.

  • Com suspensão de escrita: aproximadamente 2 a 10 minutos (as operações de escrita ficam bloqueadas durante todo o processo).

• Possível inconsistência de metadados.

  A troca de líder do ZooKeeper desconecta todos os nós do ClickHouse do ZooKeeper. Escritas de alta frequência durante esse processo podem causar inconsistência de metadados e forçar algumas tabelas ao estado Read-only.

  Para evitar inconsistências de metadados, reduza a frequência de escrita ou interrompa as operações de escrita durante o período da troca.

Troca de líder

1. Faça login no console do ApsaraDB for ClickHouse.

2. No canto superior esquerdo da página, selecione a região do cluster de destino.

3. Na página Clusters, selecione Clusters of Community-compatible Edition e clique em ID do cluster desejado.

4. Na página Cluster Information, na seção Zookeeper Configurations, em Configuration Information, clique em Scheduled Time.

5. Na caixa de diálogo Configure Primary/Secondary Switchover, revise os impactos desta operação e clique em OK.

6. Ainda na caixa de diálogo Configure Primary/Secondary Switchover, configure as opções Configure Write Suspension e Select Mode.

   • Configure Write Suspension:

     • Enable Write Suspension: a instância bloqueia todas as operações de escrita durante a troca. O processo leva de 2 a 10 minutos.

     • Disable Write Suspension: a instância realiza a troca de líder sem bloquear as operações de escrita.

   • Select Mode:

     • Scheduled Time: no campo Scheduled Time, defina um horário para a troca de líder. A troca iniciará no momento agendado.

     • Execute Immediately: o cluster inicia a troca de líder imediatamente.

7. Clique em OK.

   Nota

   Após o início da troca de líder, o status do cluster muda para Switching Primary/Secondary Node. A operação é concluída quando o status retorna a Running.

Modificar ou cancelar o agendamento

Importante

É possível modificar ou cancelar o agendamento apenas para clusters que utilizam o modo Schedule Switchover.

1. Faça login no console do ApsaraDB for ClickHouse.

2. No canto superior esquerdo da página, selecione a região do cluster de destino.

3. Na página Clusters, selecione Clusters of Community-compatible Edition e clique em ID do cluster desejado.

4. Na página Cluster Information, na seção Zookeeper Configurations, em Configuration Information, clique em Scheduled Time.

5. Na caixa de diálogo Configure Primary/Secondary Switchover, selecione Modify ou Cancel.

   • Modify: permite alterar todas as configurações da troca de líder.

   • Cancel: cancela a troca de líder agendada.