Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Manage primary/secondary switchover

Última atualização: Sep 29, 2026

O RDS aciona automaticamente a alternância entre os nós primário e secundário se o nó primário de uma instância falhar ou se o RDS aplicar uma correção de emergência no nó secundário para mitigar riscos. Durante a alternância, o RDS inverte as funções dos nós. Após a alternância, o endpoint da instância permanece inalterado e a aplicação se conecta automaticamente ao novo nó primário (o antigo nó secundário), o que garante a alta disponibilidade. Também é possível acionar a alternância manualmente.

Pré-requisitos

  • Se a instância for padrão, ela deve pertencer a uma das seguintes edições:

    • Série de alta disponibilidade

    • RDS Enterprise Edition

    • Cluster Edition

    Nota

    As instâncias da Basic Series não têm nó secundário e, portanto, não suportam a alternância entre primário e secundário.

  • Se a instância for somente leitura, ela deve pertencer à série de alta disponibilidade e usar a classe de armazenamento em cloud disk.

Informações de contexto

  • Alternância automática: este recurso vem ativado por padrão. Se o nó primário falhar, o RDS transfere automaticamente as cargas de trabalho para o nó secundário. Para obter mais informações sobre os gatilhos da alternância entre primário e secundário, consulte Reasons for primary/secondary switchover.

  • Alternância manual: mesmo com a alternância automática ativada, você pode alternar manualmente os nós primário e secundário. Essa opção é útil para simulações de recuperação de desastres ou para cenários como conexão a partir da zona mais próxima em uma implantação multizona.

Nota
  • Para instâncias da série de alta disponibilidade, os dados são sincronizados em tempo real entre os nós primário e secundário. Você só pode acesse o nó primário. O nó secundário serve exclusivamente como backup e não processa o tráfego da aplicação.

  • As instâncias somente leitura da série de alta disponibilidade também suportam a alternância de banco de dados entre primário e secundário e permitem a visualização dos logs de alternância.

Para obter informações sobre a alternância entre primário e secundário em outros mecanismos de banco de dados, consulte os seguintes tópicos:

Impacto

  • A alternância entre primário e secundário causa uma interrupção de serviço que normalmente dura 15 segundos ou menos. Certifique-se de que a sua aplicação tenha um mecanismo de reconexão automática.

    Se a sua aplicação usar uma versão mais antiga do componente Druid para gerencie conexões de banco de dados, ela poderá falhar ao se reconectar automaticamente após uma desconexão. Para evitar esse problema, atualize o componente Druid para a versão 1.1.16 ou superior.

  • Caso a instância primária tenha instâncias somente leitura anexadas, essas instâncias podem sofrer um atraso de dados de alguns minutos após a alternância. Isso ocorre porque o RDS precisa reconstruir a tarefa de replicação e sincronizar os dados incrementais.

  • A alternância entre primário e secundário não altera o endpoint da instância, mas o endereço ip subjacente pode mudar. Recomendamos o uso do endpoint para garantir que a sua aplicação continue executando normalmente durante a alternância.

  • Se a instância sofrer uma falha grave, a alternância pode levar mais tempo do que o habitual.

Alternar manualmente os nós primário e secundário

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância RDS e clique em ID da instância.

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

  3. Na seção Availability Information, clique em Switch Primary/Secondary Instance.

  4. Selecione um horário para a alternância e clique em Confirm.

    Importante

    Durante a alternância entre primário e secundário, você não pode execute operações como gerencie bancos de dados e contas ou alterar o tipo de rede. Recomendamos que você selecione Switch immediately using current settings.

    Para instâncias do Cluster Edition, você também pode alternar entre primário e secundário a partir do diagrama de topologia da instância na página Basic Information.

Desativar temporariamente a alternância automática entre primário e secundário

A alternância automática vem ativada por padrão. Quando o nó primário falha, o RDS alterna automaticamente para o nó secundário. Você pode desativar temporariamente a alternância automática nos seguintes cenários:

  • Para evitar qualquer impacto na disponibilidade do sistema durante grandes promoções de vendas.

  • Para impedir que uma alternância introduza variáveis inesperadas durante atualizações críticas da aplicação.

  • Para preservar a estabilidade do sistema durante grandes eventos ou períodos de garantia de estabilidade.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância RDS e clique em ID da instância.

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

  3. Na seção Availability Information, clique em Automatic Primary/Secondary Switchover.

    Nota

    Se o botão Automatic Primary/Secondary Switchover não for exibido, certifique-se de que a sua instância atenda aos pré-requisitos descritos neste tópico.

  4. Selecione Temporarily Disable, defina o horário de Disable Until e clique em Confirm.

    Nota
    • O RDS reativa automaticamente a alternância entre primário e secundário após o horário especificado em Disable Until.

    • O período de desativação padrão é de um dia. Você pode defina um período de desativação de até sete dias. O período termina às 23:59:59 do último dia.

Após concluir a configuração, visualize o horário de expiração da desativação temporária na página Service Availability.

Visualize logs de alternância entre primário e secundário

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância RDS e clique em ID da instância.

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

  3. Na seção Primary/Secondary Switchover Logs, especifique um intervalo de tempo para consultar os logs.

    image.png

Perguntas frequentes

  • P: Posso acesse o nó secundário?

    R: Você só pode acesse os nós secundários de instâncias do Cluster Edition. Os nós secundários de outras edições não são acessíveis.

  • P: Após uma alternância entre primário e secundário, preciso alternar manualmente de volta para o nó primário original?

    R: Não. Os dados nos nós primário e secundário estão totalmente sincronizados. Após a alternância, o antigo nó secundário se torna o novo nó primário. Nenhuma ação adicional é necessária.

  • P: Após uma alternância entre primário e secundário, o status da instância não retornou para Running há mais de 10 minutos. Quais são as possíveis causas e como resolver o problema?

    Quando um evento anormal aciona uma alternância de alta disponibilidade (HA) no RDS, as conexões persistentes da aplicação podem não detectar alterações no status da conexão. Se você não configure um valor de tempo limite para o soquete, a aplicação aguardará indefinidamente o retorno de um resultado do banco de dados e geralmente expirará após várias centenas de segundos. Durante esse período, algumas conexões de banco de dados ficam indisponíveis e as instruções SQL falham com frequência. Para evitar conexões inválidas, recomendamos configure connectTimeout e socketTimeout para impedir a espera indefinida durante erros de rede e reduzir o tempo de inatividade.

    Defina os valores de tempo limite com base na sua carga de trabalho e nos padrões de uso. Para cenários de processamento de transações online (OLTP), recomendamos defina connectTimeout para 1 a 2 segundos e socketTimeout para 60 a 90 segundos. Esses valores servem apenas como referência.

APIs relacionadas

API

Descrição

Switch primary/secondary nodes

Alterna os nós primário e secundário de uma instância RDS.

Configure automatic primary/secondary switchover

Ativa ou desativa a alternância automática entre primário e secundário para uma instância RDS.

Query primary/secondary switchover settings

Recupera a configuração de alternância automática entre primário e secundário para uma instância RDS.