Todos os produtos
Search
Central de documentação

PolarDB:Upgrade the minor version of a PolarDB cluster

Última atualização: Jun 28, 2026

Um cluster do PolarDB consiste em três camadas: o proxy de banco de dados (PolarProxy), o kernel do banco de dados (DB) e o armazenamento distribuído (Store). A atualização da versão secundária oferece os recursos mais recentes e correções de bugs. É possível atualizar o PolarProxy e o kernel de forma independente ou conjunta.

Impacto da atualização por tipo

Cada tipo de atualização afeta endpoints diferentes e apresenta perfis distintos de tempo de inatividade.

Tipo de atualização

Endpoints afetados

Tempo de inatividade estimado

Preservação de Conexão

Upgrade PolarDB Database Proxy and Kernel

Todos os endpoints

30 a 90 segundos

Não disponível

Upgrade PolarDB Database Proxy Only

Endpoint do cluster, endpoints personalizados

30 segundos

Não disponível

Upgrade Kernel Only

Endpoint primário, endpoint do cluster

30 a 60 segundos

Disponível (PolarProxy 2.3.50 ou posterior)

Ao selecionar Upgrade PolarDB Database Proxy and Kernel , o único impacto é uma desconexão de 30 a 90 segundos. As operações normais do cluster permanecem inalteradas.
Uma atualização exclusiva do proxy abrange recursos relacionados à divisão de leitura/gravação, incluindo nível de consistência (consistência global), divisão de transações e aceitação de solicitações de leitura pelo banco de dados primário. O endpoint primário não sofre alterações.

Preservação de Conexão

Em atualizações exclusivas do kernel, clusters do PolarDB com o PolarProxy 2.3.50 ou posterior podem utilizar o recurso Preservação de Conexão para manter 95% das conexões de banco de dados ativas.

Antes de começar

  • A atualização geralmente leva no máximo 30 minutos. Durante o processo, o PolarProxy ou o kernel do banco de dados reinicia, causando desconexões transitórias. Agende a atualização para horários de baixa demanda e garanta que sua aplicação tenha um mecanismo de reconexão automática.

  • Durante a atualização, operações que alteram o estado do cluster ficam indisponíveis, incluindo alterações de configuração (upgrade/downgrade), adição ou exclusão de nós, modificação de parâmetros e reinicialização de nós. Recursos de consulta, como monitoramento de desempenho, continuam funcionando normalmente.

  • Não há suporte para downgrades. Não é possível reverter a versão após a atualização.

  • Se houver alertas do CloudMonitor configurados para seu cluster do PolarDB, você receberá notificações sobre exceções de acesso ao cluster durante a atualização.

Visualize informações da versão

  1. Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a region onde o cluster está localizado e clique no ID do cluster para acessar a página de detalhes.

  2. No painel de navegação à esquerda, escolha Settings and Management > Version Management.

  3. Na página Minor Version Upgrade, visualize as versões atuais do proxy e do kernel na seção Version Information.

Atualizar a versão

Se a versão atual do proxy ou do kernel não for a mais recente, realize a atualização na mesma página.

Pré-requisitos

Antes de iniciar, verifique se você:

  • Revisou a tabela de impacto da atualização e selecionou o tipo de atualização apropriado

  • Configurou um mecanismo de reconexão automática em sua aplicação

  • Agendou uma janela de manutenção durante horários de baixa demanda

Procedimento

Importante

A atualização causa desconexões transitórias nos endpoints afetados. Consulte a tabela de impacto da atualização antes de prosseguir e garanta que sua aplicação tenha um mecanismo de reconexão implementado.

  1. Acesse Settings and Management > Version Management do cluster de destino. Na página Minor Version Upgrade, na seção Upgrade Version, selecione uma das seguintes opções: Upgrade version options

    • Upgrade PolarDB Database Proxy and Kernel

    • Upgrade Kernel Only

    • Upgrade PolarDB Database Proxy Only

    Se a versão atual do proxy ou do kernel já for a mais recente, essas opções aparecerão desabilitadas.
  2. Clique em Upgrade Now ou Upgrade in Maintenance Window. Caso selecione Upgrade in Maintenance Window, visualize os detalhes da tarefa ou cancele-a na página Scheduled Tasks. Para mais informações, consulte Tarefas agendadas.