Todos os produtos
Search

Este produto

    PolarDB:Major version upgrades

    Central de documentação

    PolarDB:Major version upgrades

    Última atualização: Oct 10, 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 Multi-Master Cluster (Limitless) Edition.

    • Alterações no método de faturamento

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

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

    Para mais informações, consulte Upgrade steps.

    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 limita o tempo de inatividade do service a menos de 10 minutos.

    • 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 precisa ter largura de banda de saída suficiente; caso contrário, a velocidade da atualização será afetada.

    • As tabelas a serem migradas devem possuir restrições PRIMARY KEY ou UNIQUE com todos os campos únicos. Sem isso, 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 verificação prévia falhará e a atualização não poderá ser iniciada.

      Nota

      Tanto para tarefas de migração completa quanto incremental, retenha os logs binários por pelo menos sete dias. Após a conclusão da migração completa, mantenha-os por no mínimo 24 horas. Se esses requisitos de retenção não forem atendidos, o DTS poderá não conseguir obter os logs binários, causando falha na tarefa, inconsistência ou perda de dados. O descumprimento dessas exigências pode afetar o SLA do DTS.

    • Restrições operacionais 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. A execução dessas operações causa falha na tarefa de migração.

    Limites de instruções SQL

    Nota

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

    • As seguintes operações DML são suportadas:

      • INSERT

      • UPDATE

      • DELETE

    • As seguintes operações DDL são suportadas:

      • 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

    • Novos bancos de dados não podem ser migrados. 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 tabelas no banco de dados de destino, tornando seu tablespace maior que o da source.

    • Verifique se as configurações de precisão das 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.

    • Clusters em uma rede global de bancos de dados (GDN) não podem ser atualizados.

    • PolarDB for MySQL Multi-master Cluster (Database/Table) Edition does not support SSL on endpoints. Endpoint switching is unavailable when upgrading an SSL-enabled source cluster to this edition.

    • A sincronização inicial completa de dados durante a atualização consome 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 tabelas devido a operações INSERT simultâneas, resultando em um tablespace de destino maior que o de source.

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

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

    • Caso o cluster em atualização faça parte de uma tarefa existente do DTS, use perform a DTS task switchover para redirecionar a tarefa do DTS para o novo cluster.

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

      • Versão do mecanismo de banco de dados: o novo algoritmo do otimizador pode diferir do anterior, resultando em comportamento de execução distinto.

      • Estrutura de armazenamento e estatísticas: os bancos de dados antigo e novo utilizam estruturas de B-tree 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 detalhes sobre as regras de faturamento das tarefas do DTS, consulte Billing overview.

      • 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 reembolso por cancelamento para reduzir custos. Para mais informações, consulte Unsubscription refund after an upgrade.

      • Troca com endpoints

      Ao atualizar um cluster do PolarDB for MySQL, é possível trocar os endpoints entre os clusters de source e destino. As figuras a seguir ilustram 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

        Nas atualizações de edição, você pode especificar quais endpoints trocar entre os clusters de source e destino. Por exemplo, é possível trocar entre o endpoint primário do cluster de source e o endpoint de cluster do destino, entre o endpoint primário da source e o endpoint personalizado do destino, ou entre o endpoint de cluster da source e o endpoint personalizado do destino. A figura abaixo mostra o mapeamento de endpoints internos.image

      Ao utilizar 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 só ocorre se ambos os clusters possuírem os endpoints correspondentes. 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 que a troca seja bem-sucedida.

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

      • Nas atualizações de edição, especifique quais pares de endpoints trocar e se deseja trocar múltiplos grupos.

      • Para trocar para um endpoint diferente, crie-o antes da transição. Para mais informações sobre como criar endpoints em um cluster PolarDB, consulte Manage endpoints.

      • As portas não são trocadas junto com os endpoints. Certifique-se de que os clusters de source e destino usem a mesma porta. Clusters do PolarDB usam a porta 3306 por padrão. Change the endpoint and port number.

      • Após a troca, caches DNS desatualizados podem causar falhas de conexão ou acesso somente leitura. Atualize o cache DNS para resolver esse problema.

      Avaliação da atualização

      O recurso de avaliação de atualização é fornecido pelo PolarDB para garantir a execução bem-sucedida e a alta eficiência das tarefas de atualização. Esse recurso permite verificar previamente 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. Dessa forma, você identifica fatores que podem afetar o progresso da atualização e resolve problemas antecipadamente, reduzindo custos de processamento e recursos durante o processo.

      Para mais informações, consulte Upgrade assessment.

      Serviço especializado

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

      image