Todos os produtos
Search
Central de documentação

PolarDB:Upgrade the minor version of a PolarDB cluster

Última atualização: Sep 02, 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). Atualizar a versão secundária fornece 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 um perfil distinto 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 é a desconexão de 30 a 90 segundos. As operações normais do cluster não sofrem alteração.
A atualização exclusiva do proxy abrange recursos relacionados à divisão de leitura e escrita, 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 permanece inalterado.

Preservação de Conexão

Na atualização exclusiva do kernel, clusters do PolarDB com PolarProxy 2.3.50 ou posterior podem usar 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 fora dos horários de pico 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, permanecem disponíveis.

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

  • Se você configurou alertas do CloudMonitor para seu cluster do PolarDB, 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, atualize-a na mesma página.

Pré-requisitos

Antes de começar, certifique-se de ter:

  • Revisado a tabela de impacto da atualização e selecionado o tipo de atualização apropriado

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

  • Uma janela de manutenção agendada fora dos horários de pico

Procedimento

Importante

A atualização causa desconexões transitórias nos endpoints afetados. Revise 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 desativadas.
  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 Scheduled tasks.