Todos os produtos
Search
Central de documentação

Tair (Redis® OSS-Compatible):Perform a manual master-replica switchover

Última atualização: Jun 26, 2026

O switchover manual de mestre/réplica troca as funções dos nós mestre e réplica em instâncias do Tair (compatível com Redis OSS), permitindo controlar a instância em cenários sem falhas. Use este recurso para simulações de recuperação de desastres ou para reduzir a latência de rede entre zonas. Essa operação difere do failover automático do sistema, acionado apenas quando um nó fica indisponível.

Cenários

Casos de uso comuns:

  • Simulações de recuperação de desastres: Simule uma falha de nó fora do horário de pico para verificar a resiliência da aplicação durante switchovers de banco de dados.

  • Otimização da latência de acesso: Se a aplicação e o nó mestre estiverem em zonas diferentes, transfira a função de mestre para o nó na zona da aplicação para reduzir a latência de rede.

Exemplo

Neste exemplo, a instância ECS da aplicação está na Zona B, enquanto o nó mestre do Tair está na Zona A. Conexões entre zonas aumentam a latência de rede e podem degradar o desempenho.

Cross-zone access example

Após o switchover, o nó da Zona B torna-se o mestre. Apenas a função do nó muda; a zona e o ID permanecem os mesmos. Assim, a instância ECS e o banco de dados se conectam dentro da mesma zona, minimizando a latência.

Impactos do switchover

Antes de executar um switchover, observe os seguintes impactos:

  • Os nós de dados envolvidos no switchover são desconectados por alguns segundos. Essa operação apresenta riscos potenciais de perda de dados. Por exemplo, pode haver inconsistência entre os nós mestre e réplica devido à latência de sincronização. Para evitar perdas de dados causadas pelo switchover e escritas duplicadas decorrentes do cache do Domain Name System (DNS), os nós de dados permanecem em modo somente leitura por até 30 segundos.

  • Quando uma instância entra no estado Switching, não é possível gerenciá-la. Nesse período, você não pode modificar configurações nem migrar a instância para outra zona.

Nota

Sobre switchovers transparentes

Se a instância e o cliente atenderem aos requisitos de versão abaixo, será possível realizar um switchover transparente, evitando desconexões transitórias e o estado de somente leitura:

  • Versão da instância: 7.0.2.9 ou posterior.

  • Versão do cliente: Valkey-Java 5.3.0 ou posterior, ou Valkey-Go 1.0.67 ou posterior.

Procedimento

  1. Faça login no console e acesse a página Instances. Na barra de navegação superior, selecione a região onde reside a instância que deseja gerenciar. Em seguida, localize a instância e clique em ID da instância.

  2. No painel de navegação à esquerda, clique em Service Availability.

  3. Na área Data Node, selecione o shard de dados alvo do switchover e clique em Failover.

    Nota

    Em instâncias cluster, esta página exibe as zonas dos nós mestre e réplica de cada shard de dados.

  4. No painel exibido, defina quando o switchover entrará em vigor.

    • Apply Immediately: O switchover entra em vigor imediatamente.

    • Effective Within Maintenance Window: O switchover é executado durante a janela de manutenção configurada. Definir uma janela de manutenção.

    Nota

    Ao selecionar Effective Within Maintenance Window, o sistema inicia imediatamente os preparativos, como solicitação de recursos e sincronização de dados. O status da instância muda para Switching, mas seus serviços não sofrem impacto. A troca efetiva de funções e seus efeitos (desconexões transitórias e estado de somente leitura) ocorrem apenas quando a Maintenance Window começa.

  5. Clique em OK.

    Conclua a autenticação secundária (como Multi-Factor Authentication (MFA)) conforme solicitado. Após a aprovação, nenhuma reautenticação será necessária pelos próximos 15 minutos.

Operações de API relacionadas

Operação de API

Descrição

SwitchInstanceHA - Executar um switchover de HA de instância

Realiza um switchover manual de mestre/réplica para simulações de recuperação de desastres ou otimização de acesso mais próximo em implantações multizona.

Referências

O Tair (compatível com Redis OSS) também suporta failover automático. O sistema monitora continuamente a integridade dos nós. Caso o nó mestre fique indisponível, o sistema promove automaticamente a réplica a mestre, garantindo alta disponibilidade do serviço. Para mais informações, consulte Alta disponibilidade.