Todos os produtos
Search
Central de documentação

PolarDB:Major version upgrades

Última atualização: Jun 28, 2026

PolarDB for MySQL permite atualizar clusters entre versões e edições principais. O sistema cria automaticamente um cluster de destino e sincroniza os dados da source. O cluster de destino do PolarDB for MySQL mantém as contas, bancos de dados, listas de permissões de IP e parâmetros necessários do cluster de source do PolarDB for MySQL.

  • Atualizações de versão

    • Atualize um cluster do PolarDB for MySQL 5.6 para um cluster do PolarDB for MySQL 5.7, 8.0.1 ou 8.0.2.

    • Atualize um cluster do PolarDB for MySQL 5.7 para um cluster do PolarDB for MySQL 8.0.1 ou 8.0.2.

    • Atualize um cluster do PolarDB for MySQL 8.0.1 para um cluster do PolarDB for MySQL 8.0.2.

  • Atualizações de edição

    Cluster da Enterprise Edition: atualize da Cluster Edition para a edição Multi-master cluster (Limitless).

  • Alterações no método de faturamento

    • Altere um cluster por assinatura ou de pagamento conforme o uso com especificações definidas para um cluster serverless.

    • Altere um cluster serverless para um cluster por assinatura ou de pagamento conforme o uso com especificações definidas.

Para mais informações, consulte Etapas de atualização.

Benefícios

  • Os endpoints do cluster de source são mantidos, eliminando a necessidade de alterar conexões nas aplicações.

  • A migração incremental mantém o tempo de inatividade do serviço abaixo de 10 minutos.

  • As atualizações a quente causam apenas uma interrupção transitória de conexão.

  • O rollback restaura o cluster em até 10 minutos caso a atualização falhe.

Limites

Categoria

Descrição

Limites do banco de dados de source

  • O servidor do banco de dados de source deve ter largura de banda de saída suficiente; caso contrário, a velocidade de atualização será afetada.

  • As tabelas a migrar devem ter restrições PRIMARY KEY ou UNIQUE com todos os campos únicos. Caso contrário, o banco de dados de destino poderá conter registros duplicados.

  • Para migração incremental, ative o log binário e defina o parâmetro loose_polar_log_bin como ON no console do PolarDB. Caso contrário, a pré-verificação falhará e não será possível iniciar a atualização.

    Nota

    Retenha os logs binários por pelo menos sete dias tanto para tarefas de migração completa quanto incremental. Após a conclusão da migração completa, mantenha-os por pelo menos 24 horas. Caso contrário, o DTS pode falhar ao obter os logs binários, causando falha na tarefa, inconsistência ou perda de dados. O descumprimento desses requisitos de retenção pode afetar o SLA do DTS.

  • Limites de operação no banco de dados de source:

    Não execute operações DDL que alterem esquemas de banco de dados ou tabelas durante a migração de esquema e a migração completa de dados. Caso contrário, a tarefa de migração falhará.

Limites de instruções SQL

Nota

As palavras-chave do PolarDB for MySQL são 100% compatíveis com as do MySQL.

  • Há suporte às seguintes operações DML:

    • INSERT

    • UPDATE

    • DELETE

  • Há suporte às seguintes operações DDL:

    • ALTER TABLE e ALTER VIEW

    • CREATE FUNCTION, CREATE INDEX, CREATE PROCEDURE, CREATE TABLE e CREATE VIEW

    • DROP INDEX e DROP TABLE

    • RENAME TABLE

    • TRUNCATE TABLE

Outros limites

  • Não é possível migrar novos bancos de dados. Para adicionar um, abra o console do DTS, modifique os objetos de sincronização e adicione o banco de dados às tarefas de sincronização direta e reversa.

  • Avalie o impacto no desempenho de ambos os bancos de dados antes da migração. Execute a migração fora dos horários de pico, pois o DTS utiliza recursos de leitura e gravação de ambos os bancos durante a migração completa, o que pode aumentar a carga do servidor.

  • Durante a migração completa, operações INSERT simultâneas causam fragmentação de tabela no banco de dados de destino, tornando seu tablespace maior que o da source.

  • Verifique se as configurações de precisão para colunas FLOAT e DOUBLE atendem aos seus requisitos. O DTS usa a função ROUND(COLUMN,PRECISION) para essas colunas. Se nenhuma precisão for especificada, o DTS usará como padrão 38 dígitos para FLOAT e 308 dígitos para DOUBLE.

  • O DTS tenta novamente tarefas de migração com falha por até sete dias. Antes de transferir cargas de trabalho para o cluster de destino, pare ou libere a tarefa de migração, ou execute o comando revoke para revogar as permissões de gravação do DTS no cluster de destino. Caso contrário, tarefas retomadas sobrescreverão os dados de destino com os dados de source.

Outras questões

O DTS executa periodicamente a instrução CREATE DATABASE IF NOT EXISTS 'test' no banco de dados de source para avançar a posição do log binário.

Observações de uso

  • Se o SSL estiver ativado no endpoint do cluster de source e você selecionar Switch with Endpoints, ative o SSL também no endpoint do cluster de destino.

  • Não é possível atualizar clusters em uma rede global de bancos de dados (GDN).

  • A edição Multi-master Cluster (Database/Table) do PolarDB for MySQL não suporta SSL em endpoints. A troca de endpoints fica indisponível ao atualizar um cluster de source com SSL ativado para esta edição.

  • A sincronização inicial completa de dados durante a atualização utiliza recursos de leitura e gravação de ambos os bancos de dados, o que pode aumentar a carga.

  • A sincronização completa de dados causa fragmentação de tabela devido a operações INSERT simultâneas, tornando o tablespace de destino maior que o da source.

  • Não libere manualmente tarefas do DTS durante a atualização.

  • A duração da sincronização completa de dados varia conforme o volume de dados. O cluster de destino exibe o status Creating até que a sincronização seja concluída.

  • Se o cluster em atualização fizer parte de uma tarefa existente do DTS, realize um switchover de tarefa do DTS para redirecionar a tarefa do DTS para o novo cluster.

  • Após a atualização, algumas instruções SQL podem apresentar desempenho mais lento devido a alterações nos planos de consulta, como seleção subótima de índices. Essas alterações decorrem de:

    • Versão do mecanismo de banco de dados: o novo algoritmo do otimizador pode diferir do anterior, causando comportamentos de execução diferentes.

    • Estrutura de armazenamento e estatísticas: os bancos de dados novo e antigo usam estruturas de árvore B do InnoDB e estatísticas de tabela diferentes, o que pode gerar planos de consulta distintos.

Regras de faturamento

  • Há cobrança pela tarefa de sincronização do DTS e pelo cluster PolarDB de destino.

    • Durante a atualização, o DTS cria automaticamente uma tarefa de sincronização da source para o destino. Para mais informações sobre as regras de faturamento das tarefas do DTS, consulte Visão geral do faturamento.

    • O cluster PolarDB de destino:

      • Clusters de destino serverless e por assinatura são faturados a partir do estado Running.

      • Clusters por assinatura exigem pagamento no momento da criação.

  • Se você não precisar mais do cluster atualizado por assinatura, solicite reembolsos de cancelamento de assinatura para reduzir custos. Para mais informações, consulte Reembolso de cancelamento de assinatura após uma atualização.

  • Troca com endpoints

    Ao atualizar um cluster do PolarDB for MySQL, é possível trocar endpoints entre os clusters de source e de destino. As figuras a seguir mostram o mapeamento de endpoints.

    • Mapeamento de endpoints para atualizações de versão

      PolarDB version upgrade

    • Mapeamento de endpoints para atualizações de edição da Cluster Edition para a Multi-master Cluster (Database/Table) Edition

      image

      As atualizações de edição permitem especificar quais endpoints trocar entre os clusters de source e de destino. Por exemplo, é possível trocar o endpoint primário do cluster de source pelo endpoint de cluster do cluster de destino, o endpoint primário do cluster de source pelo endpoint personalizado do cluster de destino, ou o endpoint de cluster do cluster de source pelo endpoint personalizado do cluster de destino. A figura a seguir mostra o mapeamento de endpoints internos.image

    Ao usar a troca de endpoints, observe o seguinte:

    • Apenas os endpoints são trocados. Outras configurações, como vSwitches e endereços IP virtuais, permanecem inalteradas.

    • A troca de endpoints só é possível se ambos os clusters os possuírem. Por padrão, apenas endpoints privados são trocados.

      Nota

      Se o cluster de source tiver um endpoint público, solicite um endpoint público correspondente no cluster de destino para garantir uma troca bem-sucedida.

    • Para atualizações de versão, os endpoints primários são trocados. Também é possível trocar vários grupos de endpoints.

    • Para atualizações de edição, especifique quais pares de endpoints trocar e se deseja trocar vários grupos.

    • Para trocar para um endpoint diferente, crie-o antes do switchover. Para mais informações sobre como criar endpoints para um cluster PolarDB, consulte Gerenciar endpoints.

    • As portas não são trocadas junto com os endpoints. Certifique-se de que os clusters de source e de destino usem a mesma porta. Clusters do PolarDB usam a porta 3306 por padrão. Alterar o endpoint e o número da porta.

    • Após a troca, o cache DNS obsoleto pode causar falhas de conexão ou acesso somente leitura. Atualize o cache DNS para resolver isso.

    Avaliação de atualização

    O recurso de avaliação de atualização do PolarDB garante a execução bem-sucedida das tarefas de atualização e alta eficiência. Esse recurso permite pré-verificar pré-requisitos como o status do cluster, dependências da tarefa de atualização e atributos do cluster de source antes de atualizar um cluster do PolarDB for MySQL. Assim, você identifica fatores que podem afetar o progresso da atualização e resolve problemas antecipadamente, reduzindo custos de processamento e recursos durante a atualização.

    Para mais informações, consulte Avaliação de atualização.

    Serviço especializado

    Para dúvidas sobre atualizações de versão principal, junte-se ao grupo DingTalk 43055001012 escaneando o código QR abaixo ou pesquisando pelo ID do grupo.

    image