Por que recebi um erro ao alterar ou escalar a classe da minha instância de banco de dados Amazon Aurora MySQL?

Breve descrição

Ao alterar a classe da instância de uma instância de banco de dados compatível com o Aurora MySQL, você pode receber um dos seguintes erros:

• “Cannot modify the instance class because there are no instances of the requested class available in the current instance's availability zone. Please try your request again at a later time”
• “Cannot find version abc for aurora-mysql”
• “RDS does not support creating a DB instance with the following combination”

Para solucionar esse problema, execute as seguintes ações com base no erro recebido.

Resolução

Observação: Se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Antes de solucionar o erro, é uma prática recomendada executar seus clusters de banco de dados na versão mais recente do mecanismo ou usar versões de suporte de longo prazo (LTS). As versões mais recentes do mecanismo fornecem correções para melhorar a segurança, a estabilidade e a disponibilidade da instância.

Para verificar a versão do seu cluster de banco de dados, abra o console do Amazon Relational Database Service (Amazon RDS) e verifique o valor em Versão do mecanismo. Se seu cluster de banco de dados for executado no Aurora MySQL versão 3, use a versão padrão 3.05.2 ou a versão LTS 3.04.1.

Observação: se o seu cluster de banco de dados for executado no Aurora MySQL versão 2, você só poderá usar o Amazon RDS Extended Support para versões secundárias 2.11 e 2.12. A versão 2.11.5 é a padrão.

Depois de atualizar a versão do mecanismo, instale as atualizações do sistema operacional (SO) nas instâncias do seu cluster de banco de dados. Crie um clone do Aurora para testar as atualizações do banco de dados. Algumas regiões ou zonas de disponibilidade da AWS podem não estar disponíveis em classes de instâncias anteriores, como T2 ou R3. É uma prática recomendada usar classes de instância mais novas, como T3 e R5.

Não é possível modificar a classe da instância

O erro Cannot modify the instance class (Não é possível modificar a classe da instância) ocorre quando a zona de disponibilidade não tem capacidade sob demanda suficiente para a classe de instância que você escolheu. Para resolver esse problema, aguarde alguns minutos e modifique a classe da instância novamente. Esse erro também ocorre se a classe da instância não estiver disponível para seu mecanismo e versão do Aurora na zona de disponibilidade em que a instância é executada.

Para identificar as zonas de disponibilidade que permitem seu mecanismo, versão do mecanismo e classe de instância, execute o seguinte comando describe-orderable-db-instance-options da AWS CLI:

aws rds describe-orderable-db-instance-options --engine engine_name --engine-version engine_version --db-instance-class instance-class --query 'OrderableDBInstanceOptions[].AvailabilityZones'

Observação: substitua engine-name pelo mecanismo do Aurora, engine-version pela versão do mecanismo e instance-class pela classe da instância.

Não é possível encontrar a versão

O erro Não é possível encontrar a versão ocorre quando você usa a AWS CLI para modificar a classe da instância com uma versão obsoleta ou incorreta.

Para obter o número da versão da instância de banco de dados em seu cluster de banco de dados Aurora MySQL, execute a seguinte consulta:

SELECT @@AURORA_VERSION;

Para verificar a versão do mecanismo de cluster de banco de dados, faça login no cluster e execute o seguinte comando describe-db-clusters:

aws rds describe-db-clusters \
--db-cluster-identifier example-cluster-identifier \
--query 'DBClusters[].EngineVersion' \
--output text \
--region Region-example

Observação: substitua example-cluster-identifier por seu identificador de cluster ou ARN e Region-example por sua Região.

Para atualizar o mecanismo de cluster de banco de dados, execute o seguinte comando apply-pending-maintenance-action:

aws rds apply-pending-maintenance-action --resource-identifier example-ARN --apply-action system-update --opt-in-type immediate

Observação: substitua example-ARN pelo ARN do cluster de banco de dados.

O RDS não oferece suporte à criação de uma instância de banco de dados com a seguinte combinação

Se você fizer o upgrade para a família de instâncias db.r4, mas o cluster de banco de dados executar uma versão anterior do Aurora, receberá o seguinte código de erro:

“DBInstanceClass=db.r4.large, Engine=aurora-mysql, EngineVersion=8.0.mysql_aurora.3.05.2, LicenseModel=general-public-license.”

É possível usar a família de instâncias db.r4 somente nas versões 2.x, não nas versões 3.x. Você também não pode executar classes de instância Optimized Reads em ambientes compatíveis com o Aurora MySQL. Se você tentar fazer o upgrade para a família de classes de instância r6gd ou db.r6id, receberá o seguinte código de erro:

“DBInstanceClass=db.r6gd.xlarge, Engine=aurora-mysql, EngineVersion=8.0.mysql_aurora.3.07.1, LicenseModel=general-public-license.”

Se você fizer o upgrade para a família de instâncias db.r8, mas a instância de banco de dados executar em uma versão anterior do Aurora, receberá o seguinte código de erro:

“DBInstanceClass=db.r8g.large, Engine=aurora-mysql, EngineVersion=8.0.mysql_aurora.3.05.2, LicenseModel=general-public-license.”

A família de instâncias db.r8 não está disponível em todas as versões do Aurora. Por exemplo, é possível usar a classe de instância db.r5.8xlarge somente no Aurora versão 3.08.0 e superior. Ou é possível usar a db.r7i somente na versão 3.08.0 e superior. No entanto, é possível usar a db.r7g na versão 2.12.0 e superior e na versão 3.03.1 e superior.

Para identificar a versão do mecanismo que permite a combinação de classes de mecanismo e instância, execute o seguinte comando describe-orderable-db-instance-options:

aws rds describe-orderable-db-instance-options --engine example-engine --db-instance-class example-instance-class --query 'OrderableDBInstanceOptions[].EngineVersion'

Observação: substitua example-engine pelo seu mecanismo e example-instance-class por sua classe de instância.

Informações relacionadas

Tipos de classe de instância de banco de dados