Upgrade the minor engine version of an ApsaraDB RDS for MySQL instance - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Atualize a versão secundária do mecanismo da sua instância ApsaraDB RDS for MySQL ou ApsaraDB RDS for MySQL Serverless de forma automática ou manual. A atualização fornece as melhorias de desempenho, recursos e correções de segurança mais recentes para manter seu service de banco de dados otimizado e seguro.

Para obter informações sobre atualizações de versão secundária do mecanismo para instâncias ApsaraDB RDS for MySQL ou ApsaraDB RDS for MySQL Serverless, consulte AliSQL Release Notes.

Para atualizar a versão secundária do mecanismo de outros bancos de dados, consulte os seguintes tópicos:

Status das versões

Offline: Uma versão secundária do mecanismo é descontinuada se apresentar defeitos críticos ou estiver expirada há mais de um ano. Após a definição de uma versão como offline, não é possível criar novas instâncias que utilizem essa versão.
Expirada: Uma versão secundária do mecanismo expira após sua data especificada. Para verificar as datas de expiração das versões secundárias do mecanismo, consulte AliSQL Release Notes.
Estável: Todas as versões que não estão offline nem expiradas são consideradas estáveis.

Recursos

Aviso

O recurso de atualização automática é uma ferramenta complementar e não garante a atualização imediata de todas as instâncias para a versão secundária mais recente do mecanismo. Verifique o status da sua versão secundária na página Basic Information da instância e atualize-a prontamente para evitar riscos potenciais associados a versões desatualizadas. Se você cancelar uma tarefa de atualização iniciada pelo sistema ou deixar de atualizar para a versão estável mais recente após receber uma notificação de atualização no console, será responsável por quaisquer interrupções de negócios, perda de dados ou outras consequências resultantes. Para mais informações, consulte os Termos de Serviço.

Atualização automática: Por padrão, as instâncias ApsaraDB RDS for MySQL e ApsaraDB RDS for MySQL Serverless estão configuradas para atualizar automaticamente a versão secundária do mecanismo. Quando sua instância executa uma versão desatualizada, o sistema agenda periodicamente uma tarefa de atualização. O sistema envia notificações principalmente para versões instáveis. Caso uma versão secundária não apresente problemas conhecidos de estabilidade ou segurança, o sistema pode não notificá-lo. Verifique as configurações de atualização automática na página Basic Information. A atualização ocorre dentro da maintenance window configurada.
Nota
- O sistema envia notificações sobre tarefas de atualização por canais como SMS e e-mail. Para receber essas notificações, inscreva-se em Cloud Database Failure ou O&M Notification no Message Center e configure suas informações de contato.
- Cancele ou reagende tarefas de manutenção iniciadas pelo sistema a qualquer momento. Para mais informações, consulte Scheduled Events.
Atualização manual: Altere a configuração de atualização para Manual Upgrade na página Basic Information da sua instância. Se a versão secundária atual do mecanismo da instância tiver defeitos críticos, estiver expirada ou offline, o sistema ainda agendará uma atualização, mesmo que a instância esteja configurada para atualizações manuais.

Impactos

A atualização da versão secundária do mecanismo pode causar um failover da instância. Para mais informações sobre os impactos de um failover de instância, consulte Impacts of an instance switchover.
As atualizações automáticas ocorrem dentro da janela de manutenção configurada. Modifique a janela de manutenção na página Basic Information da sua instância.
Execute atualizações manuais durante horários de baixa demanda. Certifique-se também de que o código da sua aplicação inclua um mecanismo de reconexão automática.

Observações de uso

Versões secundárias desatualizadas podem apresentar riscos como interrupções de service e perda de dados. Recomendamos atualizar a versão secundária do mecanismo regularmente ou após receber uma notificação de O&M da Alibaba Cloud.
Se uma instância primária possuir instâncias somente leitura executando uma versão anterior à versão de destino, o sistema atualizará as instâncias somente leitura antes de atualizar a instância primária.
Quando a versão secundária do mecanismo de uma instância estiver offline ou sem manutenção, o sistema atualizará automaticamente a instância para a versão secundária mais recente ao realizar uma atualização de instância, alteração de especificação ou quando a Alibaba Cloud atualizar o hardware subjacente.
Não é possível fazer downgrade da versão secundária do mecanismo após uma atualização.
Após atualizar a versão secundária de uma instância ApsaraDB RDS for MySQL ou ApsaraDB RDS for MySQL Serverless Basic Edition, o Backup Usage na página Basic Information da instância pode ser exibido como 0, sendo restaurado automaticamente após a conclusão do próximo backup agendado.
O sistema não envia tarefas de atualização para instâncias recém-criadas. Para atualizar para a versão mais recente, execute manualmente o processo de upgrade the minor engine version na página Basic Information.
Não é possível cancelar o processo de atualização após o início. Em caso de falha na atualização, todas as alterações são revertidas e a instância mantém sua versão anterior do mecanismo e metadados.
Quando uma versão secundária do mecanismo atende aos critérios para ser descontinuada, seu status muda para offline, independentemente de ainda estar dentro do ciclo de vida de suporte.

Riscos da atualização

Risco	Descrição
Risco de conexão .NET	Ao atualizar sua instância para a versão 20230630 (baseada no MySQL oficial 8.0.31) ou posterior, podem ocorrer problemas com conexões .NET. Para mais informações, consulte Problema de compatibilidade .NET.
Risco de compatibilidade	A atualização para a versão 20210930 ou posterior pode acionar um problema de compatibilidade PHP. Se esse problema ocorrer, tente estabelecer a conexão novamente.
Comportamento inconsistente do banco de dados	Algumas atualizações de versão secundária podem causar inconsistências no comportamento do banco de dados. Por exemplo, ao atualizar para uma versão baseada no MySQL oficial 8.0.19 ou posterior, o atributo 'widths' para tipos inteiros torna-se obsoleto e deixa de ser exibido. Para mais detalhes, consulte a documentação oficial do MySQL. O ApsaraDB RDS trata inconsistências comportamentais resultantes de atualizações da mesma forma que a versão oficial do MySQL.

Modificar configurações de atualização automática

Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância RDS e clique em ID da instância.
Na seção Configuration Information, localize Minor Version Auto Upgrade e clique em Settings.
Selecione Automatic Upgrade ou Manual Upgrade e clique em OK.

Atualizar manualmente a versão secundária do mecanismo

Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância RDS e clique em ID da instância.
Na seção Configuration Information, clique em Upgrade Minor Engine Version.

Nota
Se este botão não estiver visível, a versão secundária do mecanismo já está atualizada.
Na caixa de diálogo exibida, selecione uma versão na lista Upgradeable To, escolha um Upgrade Time e clique em OK.

Visualize progresso e histórico de atualizações

Para visualizar o progresso de uma atualização em andamento ou o histórico de atualizações de versão secundária, acesse a página Tasks no console do ApsaraDB RDS. É possível visualizar detalhes de cada tarefa, incluindo tipo, status, progresso, hora de início e hora de término. A página Tasks exibe apenas tarefas dos últimos 30 dias, abrangendo tanto atualizações automáticas quanto manuais. Para mais informações, consulte Task list for an ApsaraDB RDS for MySQL instance.

FAQ

P: Quais métodos posso usar para atualizar a versão secundária do mecanismo de uma instância ApsaraDB RDS for MySQL?

R: Utilize uma automatic upgrade ou uma manual upgrade.

P: Posso reverter uma atualização de versão secundária do mecanismo de uma instância ApsaraDB RDS for MySQL?

R: Não. As atualizações de versão secundária do mecanismo para RDS for MySQL são realizadas por meio de um processo contínuo no local e não podem ser revertidas.

P: Como alterno entre atualizações automáticas e manuais para a versão secundária do mecanismo de uma instância ApsaraDB RDS for MySQL?

R: Para mais informações, consulte Modify automatic upgrade settings.

P: Posso cancelar uma atualização de versão secundária do mecanismo após o início?

R: Não. Não é possível cancelar o processo de atualização após o início. Se a atualização falhar, todas as alterações serão revertidas e a instância manterá sua versão anterior do mecanismo e metadados.

P: Após uma atualização, por que a versão retornada por SELECT @@version permanece inalterada?

R: A atualização aplica-se à versão secundária do mecanismo AliSQL, não à versão do mecanismo da comunidade MySQL. Execute o comando show variables like '%rds_release_date%' para verificar a versão secundária do mecanismo AliSQL.

P: Só posso atualizar uma versão por vez?

R: Não. É possível atualizar para qualquer uma das versões secundárias mais recentes disponíveis. As versões disponíveis são exibidas no console.

P: Quais são os impactos de uma atualização de versão secundária do mecanismo? Por que ocorre um failover da instância? Existem outros riscos críticos?

R: Para garantir a estabilidade do service, a atualização é realizada primeiro na instância secundária. Após a atualização, o sistema transfere suas cargas de trabalho para a instância secundária. Não há outros riscos críticos envolvidos. Para mais informações sobre os impactos de um failover de instância, consulte Impacts of an instance switchover.

P: Ao atualizar a versão secundária do mecanismo de uma instância primária, as instâncias somente leitura também são atualizadas?

R: Sim. Se uma instância primária possuir instâncias somente leitura executando uma versão anterior à versão de destino, o sistema atualizará as instâncias somente leitura antes de atualizar a instância primária. Caso existam múltiplas instâncias somente leitura, o sistema as atualizará uma a uma, não simultaneamente.

P: Realizei uma alteração de especificação na minha instância ApsaraDB RDS for MySQL e a versão secundária do mecanismo também foi atualizada. Por quê?

R: Se a versão secundária do mecanismo de uma instância estiver offline ou sem manutenção, o sistema atualiza automaticamente a instância para a versão secundária mais recente ao realizar uma alteração de especificação ou quando a Alibaba Cloud atualiza o hardware subjacente.

P: Como visualizo o progresso e o histórico de atualizações de versão secundária do mecanismo da minha instância ApsaraDB RDS for MySQL?

R: Para mais informações, consulte View upgrade progress and history.

P: Ativei as atualizações automáticas, mas minha instância não foi atualizada. Por quê?

R: Uma atualização automática pode não ocorrer por um dos seguintes motivos:

A instância está em uma rede clássica. Atualizações automáticas não são suportadas na rede clássica. Altere o tipo de rede para VPC.
A versão do proxy é muito antiga. Atualize a versão do proxy primeiro.
Atualizações automáticas são tarefas de manutenção agendadas. O sistema não realiza uma atualização imediatamente assim que uma nova versão é lançada.

P: Posso usar uma API para atualizar a versão secundária do mecanismo e configurar a política de atualização?

R: Sim. Para mais informações, consulte Related API operations.

P: Não consigo atualizar a versão secundária do mecanismo de uma instância em uma rede clássica. Ao tentar mudar para uma VPC, nenhum vSwitch elegível está disponível na zona de disponibilidade de destino. Como crie uma VPC e há cobrança?

R: A criação de uma VPC é gratuita. Para mais informações sobre a migração da rede clássica para uma VPC, consulte Change the network type.

P: Posso optar por não atualizar a versão secundária do mecanismo? Quais são os impactos?

R: Sim, a atualização não é obrigatória. No entanto, recomendamos fortemente que atualize a versão secundária do mecanismo regularmente. Se continuar usando uma versão antiga, você não poderá utilizar novos recursos, receber patches de segurança para vulnerabilidades conhecidas ou se beneficiar de otimizações oficiais de desempenho.

APIs relacionadas

API	Descrição
UpgradeDBInstanceKernelVersion	Atualiza a versão secundária do mecanismo de uma instância ApsaraDB RDS for MySQL.
ModifyDBInstanceAutoUpgradeMinorVersion	Defina a política de atualizações de versão secundária do mecanismo como automática ou manual.

Referências

AliSQL Release Notes