Todos os produtos
Search
Central de documentação

Tair (Redis® OSS-Compatible):Upgrade the major version

Última atualização: Jun 26, 2026

Atualizar para uma versão principal mais recente oferece maior desempenho, melhor segurança e acesso a novos recursos, sem necessidade de criar uma nova instância. Após a atualização, o ID da instância, os endpoints, os dados, as configurações da lista de permissões e as contas permanecem inalterados.

Aviso

Não é possível reverter uma atualização de versão principal. Para voltar a uma versão anterior, crie uma nova instância nessa versão e migre seus dados para ela.

Elegibilidade

Nem todas as instâncias aceitam atualização da versão principal. Consulte a tabela abaixo antes de prosseguir.

Condição

Suporte

Ação necessária

Instâncias em modos de implantação diferentes

Não

A atualização só é permitida dentro do mesmo modo de implantação.

Instância de rede clássica

Parcial

A versão máxima de destino é a 5,0. Para alcançar a 6,0 ou superior, primeiro converta para cloud-native.

Instância cloud-native (arquitetura cluster, modo de conexão direta)

Não

Esta configuração não aceita atualização de versão principal.

Instância com tarefas ativas do Data Transmission Service (DTS)

Não

Pause todas as tarefas do DTS antes de tentar novamente.

Instância cluster clássica com endpoint privado

Não

Primeiro, libere o endpoint privado e tente novamente.

Instância conectada à rede clássica

Não

Libere a conexão de rede clássica antes de continuar. Não é possível restabelecê-la após a liberação. Use uma Virtual Private Cloud (VPC), que oferece maior velocidade e segurança.

Uso de memória acima de 80%

Não recomendado

Uma atualização de versão principal pode alterar o uso de memória em aproximadamente −10% a 10%. Mantenha o uso de memória abaixo de 80% antes da atualização para evitar falta de memória posteriormente.

Instância Redis Open-Source Edition 2.8

Parcial

Só é possível atualizar para a versão 5,0.

Tipo de instância descontinuado

Não

Altere a configuração da instância para um tipo disponível com a mesma capacidade de memória antes de tentar novamente.

Impacto da atualização

As tarefas de pré-atualização — provisionamento de recursos, atualização do banco de dados secundário e sincronização de dados — são executadas em segundo plano sem afetar sua instância.

A janela de impacto ocorre apenas durante o switchover da instância ou um failover primário/secundário:

  • A instância fica somente leitura por até 60 segundos durante a sincronização dos dados.

  • Ocorre uma interrupção transitória de conexão com duração de alguns segundos.

Para minimizar interrupções, agende a atualização fora dos horários de pico ou use a opção Update During Maintenance para permitir que o sistema realize o switchover durante a janela de manutenção configurada.

Compatibilidade da API de filtro Bloom (apenas Redis Open-Source Edition 4.0)

Se sua aplicação usa APIs de filtro Bloom, como BF.ADD, essas APIs deixarão de ser suportadas após uma atualização de versão principal. As operações de filtro Bloom nas primeiras instâncias do Redis 4.0 não foram lançadas oficialmente para uso público e não estão mais disponíveis em versões principais posteriores ou em novas instâncias Redis 4.0. O uso contínuo dessas operações apresenta riscos desconhecidos, incluindo falhas na análise de cache.

Migre para uma instância otimizada para memória do Tair para utilizar seus filtros Bloom otimizados.

Atualizar a versão principal no console

Importante

Certifique-se de que sua aplicação tenha um mecanismo de reconexão configurado antes de iniciar a atualização.

  1. Faça login no console e acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância está implantada. Localize a instância e clique em seu respectivo ID.

  2. Na seção Configuration Information, localize o campo Version e escolha Update > Major Update.

    Nota

    Se a opção Major Update estiver indisponível, a instância não é elegível para atualização de versão principal.

  3. No painel exibido, selecione a versão de destino e o horário de execução. Para minimizar o impacto do switchover, selecione Update During Maintenance. O sistema executará o switchover durante a janela de manutenção da instância. Para mais detalhes, consulte Definir uma janela de manutenção.

  4. Clique em OK.

Perguntas frequentes

Por que a atualização falhou?

A atualização falha se a instância for um tipo de instância descontinuado. Altere a configuração da instância para um tipo disponível com a mesma capacidade de memória e tente novamente a atualização da versão principal.

O status da instância mudou para "Upgrading" imediatamente após eu selecionar Update During Maintenance. Há algo errado?

Não. O sistema está executando tarefas de pré-atualização, como provisionamento de recursos e sincronização de dados. Essas tarefas não envolvem switchover de instância ou failover primário/secundário e não afetam os serviços da sua instância. O período somente leitura e a interrupção transitória de conexão ocorrem apenas durante o próprio switchover.

A atualização da versão principal é gratuita?

Sim. As atualizações de versão principal são gratuitas.

Posso fazer downgrade após a atualização?

Não. Para executar uma versão anterior, crie uma nova instância nessa versão e migre seus dados para ela.

Para qual versão uma instância Redis Open-Source Edition 2.8 pode ser atualizada?

Uma instância Redis Open-Source Edition 2.8 só pode ser atualizada para a versão 5,0.

Como atualizo uma instância clássica 5,0 para a 6,0?

Converta a instância clássica em uma instância cloud-native e selecione o Redis 6.0 ou uma versão posterior durante a conversão.

Próximos passos