Como as atualizações locais afetam os grupos de parâmetros de um cluster Alterações nas propriedades do cluster entre as versões do Aurora MySQL Principais atualizações no local para bancos de dados globais Considerações sobre retrocesso

Como realizar uma atualização local

Recomendamos revisar o material de base em Como funciona a atualização da versão principal no local Aurora MySQL.

Execute qualquer planejamento e teste de pré-atualização, conforme descrito em Planejando uma atualização de versão principal para um cluster de Aurora MySQL.

O exemplo a seguir atualiza o cluster de banco de dados mydbcluster-cluster para o Aurora MySQL versão 3.04.1.

Para atualizar a versão principal de um cluster de bancos de dados Aurora MySQL

Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.
Se você usou um grupo de parâmetros personalizado com o cluster de banco de dados original, crie um grupo de parâmetros correspondente compatível com a nova versão principal. Faça todos os ajustes necessários aos parâmetros de configuração nesse novo grupo de parâmetro. Para ter mais informações, consulte Como as atualizações locais afetam os grupos de parâmetros de um cluster.
No painel de navegação, escolha Databases (Bancos de dados).
Na lista, escolha o cluster de banco de dados que deseja modificar.
Selecione Modify.
Em Version (Versão), selecione uma versão principal do Aurora MySQL.

Recomendamos usar a versão secundária mais recente da versão principal. Aqui, escolhemos a versão padrão atual.
Escolha Continue.
Na próxima página, especifique quando executar a atualização. Escolha During the next scheduled maintenance window (Durante a próxima janela de manutenção programada) ou Immediately (Imediatamente).
(Opcional) Examine periodicamente a página Events (Eventos) no console do RDS durante a atualização. Isso ajuda você a monitorar o progresso da atualização e identificar quaisquer problemas. Se a atualização encontrar quaisquer problemas, consulte Solução de problemas para atualização no local de Aurora MySQL para as etapas a serem realizadas.
Se você criou um grupo de parâmetros no início deste procedimento, associe o grupo de parâmetros personalizado ao cluster atualizado. Para ter mais informações, consulte Como as atualizações locais afetam os grupos de parâmetros de um cluster.

nota
A execução desta etapa exige que você reinicie o cluster novamente para aplicar o novo grupo de parâmetro.
(Opcional) Depois de concluir qualquer teste pós-atualização, exclua o snapshot manual que Aurora criado no início da atualização.

Para atualizar a versão principal de um cluster de bancos de dados Aurora MySQL, use o comando da AWS CLI modify-db-cluster com os seguintes parâmetros obrigatórios:

--db-cluster-identifier
--engine-version
--allow-major-version-upgrade
--apply-immediately ou --no-apply-immediately

Se o cluster usar quaisquer grupos de parâmetros personalizados, inclua também uma ou ambas as opções a seguir:

--db-cluster-parameter-group-name, se o cluster usar um grupo de parâmetros de cluster personalizado
--db-instance-parameter-group-name, se alguma instância no cluster usar um grupo de parâmetro de banco de dados personalizado

O exemplo a seguir atualiza o cluster de banco de dados sample-cluster para o Aurora MySQL versão 3.04.1. A atualização acontece imediatamente, em vez de aguardar a próxima janela de manutenção.

exemplo

Para Linux, macOS ou Unix:


aws rds modify-db-cluster \
          --db-cluster-identifier sample-cluster \
          --engine-version 8.0.mysql_aurora.3.04.1 \
          --allow-major-version-upgrade \
          --apply-immediately

Para Windows:


aws rds modify-db-cluster ^
          --db-cluster-identifier sample-cluster ^
          --engine-version 8.0.mysql_aurora.3.04.1 ^
          --allow-major-version-upgrade ^
          --apply-immediately

Você pode combinar outros comandos CLI com modify-db-cluster para criar um processo completo automatizado para executar e verificar atualizações. Para ter mais informações e exemplos, consulte Tutorial de atualização no local de Aurora MySQL.

nota

Se o cluster fizer parte de um banco de dados Aurora global, o procedimento de atualização local será ligeiramente diferente. Você chama a operação de comando modify-global-cluster em vez de modify-db-cluster. Para ter mais informações, consulte Principais atualizações no local para bancos de dados globais.

Para atualizar a versão principal de um cluster de banco de dados do Aurora MySQL, use a operação ModifyDBCluster da API do RDS com os seguintes parâmetros necessários:

DBClusterIdentifier
Engine
EngineVersion
AllowMajorVersionUpgrade
ApplyImmediately (definido como true ou false)

nota

Se o cluster fizer parte de um banco de dados Aurora global, o procedimento de atualização local será ligeiramente diferente. Você chama a operação ModifyGlobalCluster em vez de ModifyDBCluster. Para ter mais informações, consulte Principais atualizações no local para bancos de dados globais.

Como as atualizações locais afetam os grupos de parâmetros de um cluster

Os grupos de parâmetros do Aurora têm diferentes conjuntos de configurações para clusters que são compatíveis com MySQL 5.7 ou 8.0. Quando você realiza uma atualização no local, o cluster atualizado e todas as instâncias devem usar grupos de parâmetros de instância e cluster correspondentes:

Seu cluster e suas instâncias podem usar os grupos de parâmetros padrão compatíveis com 5.7. Em caso afirmativo, o cluster atualizado e a instância iniciarão com os grupos de parâmetros padrão compatíveis com 8.0. Se o cluster e as instâncias usarem quaisquer grupos de parâmetros personalizados, crie grupos de parâmetros correspondentes ou compatíveis com 8.0. Além disso, especifique-os durante o processo de atualização.

nota

Para a maioria das configurações de parâmetros, é possível selecionar o grupo de parâmetros personalizado em dois pontos. É quando você cria o cluster ou associa o grupo de parâmetros ao cluster mais tarde.

No entanto, se você utilizar uma configuração não padrão para o parâmetro lower_case_table_names, deverá configurar o grupo de parâmetros personalizado com essa configuração com antecedência. Em seguida, especifique o grupo de parâmetros ao realizar a restauração do snapshot para criar o cluster. Qualquer alteração no parâmetro lower_case_table_names não terá efeito após a criação do cluster.

Recomendamos que você use a mesma configuração para lower_case_table_names ao atualizar do Aurora MySQL versão 2 para a versão 3.

Com um banco de dados Aurora global baseado no Aurora MySQL, você não poderá executar uma atualização no local do Aurora MySQL versão 2 para a versão 3 se o parâmetro lower_case_table_names estiver ativado. Para ter mais informações sobre os métodos que você pode usar, consulte Atualizações de versão principal.

Importante

Se você especificar qualquer grupo de parâmetros personalizado durante o processo de atualização, será necessário reinicializar manualmente o cluster após a conclusão da atualização. Isso faz com que o cluster comece a usar suas configurações de parâmetros personalizadas.

Alterações nas propriedades do cluster entre as versões do Aurora MySQL

Ao realizar o upgrade do Aurora MySQL versão 2 para a versão 3, verifique todas as aplicações ou scripts utilizados para configurar ou gerenciar clusters e instâncias de banco de dados do Aurora MySQL.

Além disso, altere seu código que manipula grupos de parâmetros para explicar o fato de que os nomes dos grupos de parâmetros padrão são diferentes para os clusters compatíveis com as versões 5.7 e 8.0. Os nomes dos grupos de parâmetros padrão para clusters do Aurora MySQL versão 2 e 3 são default.aurora-mysql5.7 e default.aurora-mysql8.0, respectivamente.

Por exemplo, você pode ter um código como abaixo que se aplica ao cluster antes de uma atualização.


# Check the default parameter values for MySQL 5.7–compatible clusters.
aws rds describe-db-parameters --db-parameter-group-name default.aurora-mysql5.7 --region us-east-1

Depois de atualizar a versão principal do cluster, altere esse código da seguinte forma.


# Check the default parameter values for MySQL 8.0–compatible clusters.
aws rds describe-db-parameters --db-parameter-group-name default.aurora-mysql8.0 --region us-east-1

Principais atualizações no local para bancos de dados globais

Para um Aurora Global Database, você atualiza o cluster de banco de dados global. O Aurora atualiza automaticamente todos os clusters ao mesmo tempo e garante que todos eles executem a mesma versão do mecanismo. Esse requisito ocorre porque todas as alterações nas tabelas do sistema, formatos de arquivo de dados e outros são replicadas automaticamente para todos os clusters secundários.

Siga as instruções em Como funciona a atualização da versão principal no local Aurora MySQL. Quando você especificar o que deve ser atualizado, escolha o cluster de banco de dados global em vez de um dos clusters que ele contém.

Se você usar o AWS Management Console, escolha o item com a função Global database (Banco de dados global).

Atualizar o cluster de banco de dados global

Se você usar a AWS CLI ou a API do RDS, inicie o processo de atualização chamando o comando modify-global-cluster ou a operação ModifyGlobalCluster. Você usa um desses em vez de modify-db-cluster ou ModifyDBCluster.

nota

Você não pode especificar um grupo de parâmetros personalizado para o cluster de banco de dados global enquanto estiver realizando uma atualização de versão principal desse banco de dados global do Aurora. Crie seus grupos de parâmetros personalizados em cada região do cluster global. Depois, aplique-os manualmente aos clusters regionais após a atualização.

Para atualizar a versão principal de um cluster de bancos de dados do Aurora MySQL, use o comando modify-global-cluster da AWS CLI com os seguintes parâmetros obrigatórios:

--global-cluster-identifier
--engine aurora-mysql
--engine-version
--allow-major-version-upgrade

O exemplo a seguir atualiza o cluster de banco de dados global para a Aurora MySQL versão 2.10.2.

exemplo

Para Linux, macOS ou Unix:


aws rds modify-global-cluster \
          --global-cluster-identifier global_cluster_identifier \
          --engine aurora-mysql \
          --engine-version 5.7.mysql_aurora.2.10.2 \
          --allow-major-version-upgrade

Para Windows:


aws rds modify-global-cluster ^
          --global-cluster-identifier global_cluster_identifier ^
          --engine aurora-mysql ^
          --engine-version 5.7.mysql_aurora.2.10.2 ^
          --allow-major-version-upgrade

Considerações sobre retrocesso

Se o cluster que você atualizou tiver o recurso de retrocesso ativado, você não poderá retroceder o cluster atualizado para antes da atualização.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Tutorial de atualização no local de Aurora MySQL