Solução de problemas de versões de mecanismo e instâncias de banco de dados BYOM
A tabela a seguir ajuda a diagnosticar e resolver problemas comuns ao criar e gerenciar versões de mecanismo e instâncias de banco de dados BYOM (Traga sua própria mídia) para o RDS para SQL Server.
| Mensagem de erro/sintoma | Causa | Correção recomendada |
|---|---|---|
InvalidParameterValue: RDS can't create the custom engine version because the provided <Name>.ISO file doesn't match the expected installer file for engine version 15.00.4435.7.v1 |
O arquivo RTM enviado não corresponde à versão principal ou à edição do SQL Server especificada no comando. Por exemplo, foi enviado um arquivo ISO do SQL Server 2022 ao tentar criar uma versão de mecanismo 2019 (15.xx). | 1. Verifique se o prefixo da versão de mecanismo corresponde ao arquivo ISO: 15.xx = SQL Server 2019, 16.xx = SQL Server 2022. 2. Verifique se o parâmetro do mecanismo corresponde à edição correta: sqlserver-ee = Enterprise, sqlserver-se = Standard. 3. Envie o arquivo RTM correto para o S3. 4. Exclua a versão de mecanismo BYOM com falha, caso ela tenha sido criada. 5. Execute novamente create-custom-db-engine-version usando o arquivo ISO correspondente. |
CreateCustomDBEngineVersionFault: RDS was unable to access the specified installer file in the S3 bucket. |
O RDS não conseguiu acessar o bucket do S3, ou o arquivo ISO não foi encontrado no local especificado do S3. | 1. Verifique se o bucket do S3 não possui políticas que bloqueiem o acesso do serviço RDS. 2. Verifique se o nome do bucket do S3 informado em --database-installation-files-s3-bucket-name está correto. 3. Verifique se o nome do arquivo informado em --database-installation-files corresponde exatamente ao arquivo enviado. 4. Confirme se o bucket está na mesma região que a versão de mecanismo BYOM. 5. Verifique se há SCPs ou políticas de endpoint da VPC que possam estar bloqueando o acesso. 6. Tentar novamente create-custom-db-engine-version. |
InvalidParameterValue: RDS can't create the custom engine version because the provided file doesn't match the expected installer file for engine version |
O arquivo CU não corresponde à versão de mecanismo de destino. | 1. Identifique o número KB da atualização cumulativa (CU) correto para a versão secundária de destino. 2. Execute novamente create-custom-db-engine-version usando a versão CU correspondente. |
InvalidParameterValue: The custom engine version isn't valid. Names can include only lowercase letters (a-z), dashes (-), underscores (_), and periods (.). Specify a valid CEV, refer to https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.create, and try again. |
Verifique se o nome da sua CEV usa apenas caracteres compatíveis e se você está usando uma edição ou versão do SQL Server compatível com BYOM. | 1. Verifique se você está usando um mecanismo compatível: sqlserver-ee ou sqlserver-se. 2. Verifique se a versão de mecanismo é SQL Server 2019 (15.xx) ou SQL Server 2022 (16.xx). 3. Tente novamente usando uma edição e uma versão compatíveis. |
InvalidCustomDBEngineVersionStateFault: You can't delete custom engine version sqlserver-ee 15.00.4465.1.v1. At least one instance and one backup is using the CEV. Change the version or delete the instances and backups, and try again. |
Instâncias de banco de dados, snapshots ou réplicas de leitura ainda estão usando a versão BYOM. | 1. Identifique os recursos que usam essa versão: aws rds describe-db-instances --query "DBInstances[?EngineVersion=='<version>']". 2. Identifique os snapshots: aws rds describe-db-snapshots --query "DBSnapshots[?EngineVersion=='<version>']". 3. Migre as instâncias para uma versão diferente ou exclua-as. 4. Exclua os snapshots e os backups automatizados associados. 5. Tentar novamente delete-custom-db-engine-version. |
InvalidParameterCombination: The LicenseModel parameter is required for configurations with multiple options. |
O BYOM está ativado para essa versão, mas --license-model foi omitido. |
Adicione --license-model bring-your-own-media ou --license-model license-included ao seu comando. |
The combination of engine sqlserver-se and version <version> isn't valid. Enter a valid custom engine version, and try again. |
Esse erro ocorre quando: (1) Não existe nenhuma versão de mecanismo BYOM para a versão de mecanismo de destino; (2) A versão do mecanismo BYOM de destino está com o status incompatible-media ou inactive; (3) A versão especificada do mecanismo não corresponde a uma combinação compatível de versão principal/secundária. |
Para verificar as versões de mecanismo compatíveis, execute describe-db-engine-versions e crie primeiro uma versão de mecanismo BYOM usando create-custom-db-engine-version. |
InvalidParameterCombination: RDS can't perform the operation because the custom engine version <version> is in incompatible-installation-media status. Choose a custom engine version in one of the following statuses and try again: available, creating, pending-validation, validating. |
A versão de mecanismo BYOM falhou na etapa de validação. | Exclua a versão de mecanismo BYOM com falha, envie novamente a mídia de instalação correta e crie uma nova versão de mecanismo BYOM. |
InvalidParameterCombination: RDS does not support creating a DB instance with the following combination: DBInstanceClass=<instance class>, Engine=<Edition>, EngineVersion=<version>, LicenseModel=bring-your-own-media. For supported combinations of instance class and database engine version, see the documentation. |
O tipo de instância especificado não é compatível com BYOM. | Para verificar se sua classe de instância é compatível com BYOM, use a API describe-orderable-db-instance-options: aws rds describe-orderable-db-instance-options --engine sqlserver-ee --engine-version <version> --db-instance-class <instance-class> --region <region> --query "OrderableDBInstanceOptions[?LicenseModel=='bring-your-own-media']". Como alternativa, consulte as classes de instância compatíveis em página de preços do Amazon RDS para SQL Server |
InvalidParameterCombination: The combination of engine and version isn't valid. Enter a valid custom engine version, and try again. (em ModifyDBInstance) |
Para atualizar uma instância BYOM, deve existir uma versão de mecanismo BYOM para a versão de destino e ela deve estar, no mínimo, com o status available. A chamada para modify-db-instance é rejeitada quando: não existe uma versão de mecanismo BYOM para a versão de mecanismo de destino; a versão de mecanismo BYOM de destino está com o status incompatible-media ou inactive; a versão de destino não está presente na matriz ValidUpgradeTarget. |
Use o comando describe-db-engine-versions para listar os destinos válidos para atualização de versão secundária. Antes de aplicar uma atualização de versão secundária a uma instância BYOM, verifique se existe uma versão de mecanismo BYOM válida para a versão de destino. Caso não exista, crie uma e aguarde até que ela fique disponível. |