BYOM エンジンのバージョンと DB インスタンスのトラブルシューティング
次の表は、RDS for SQL Server の Bring Your Own Media (BYOM) エンジンバージョンと DB インスタンスを作成および管理する際の一般的な問題の診断と解決に役立ちます。
| エラーメッセージ / 症状 | 原因 | 推奨される修正 |
|---|---|---|
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 |
アップロードされた RTM ファイルが、コマンドで指定された SQL Server メジャーバージョンまたはエディションと一致しません。例えば、2019 エンジンバージョン (15.xx) をターゲットにしながら SQL Server 2022 ISO をアップロードする場合などです。 | 1. エンジンバージョンのプレフィックスが ISOと一致していることを確認します。(15.xx = SQL Server 2019、16.xx = SQL Server 2022)。2. エンジンパラメータがエディションと一致することを確認します。(sqlserver-ee = Enterprise、sqlserver-se = Standard)。3. 正しい RTM ファイルを S3 にアップロードします。4. 失敗した BYOM エンジンバージョンが作成された場合は削除します。5. 一致する ISO を使用して create-custom-db-engine-version を再試行します。 |
CreateCustomDBEngineVersionFault: RDS was unable to access the specified installer file in the S3 bucket. |
RDS が S3 バケットにアクセスできなかったか、指定された S3 ロケーションに ISO ファイルが見つかりませんでした。 | 1. S3 バケットに RDS サービスアクセスをブロックするポリシーがないことを確認します。2. --database-installation-files-s3-bucket-name の S3 バケット名を確認します。3. --database-installation-files のファイル名が完全に一致することを確認します。4. バケットが BYOM エンジンバージョンと同じリージョンにあることを確認します。5. アクセスをブロックする可能性のある SCP または VPC エンドポイントポリシーを確認します。6. 再試行。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 |
CU ファイルがターゲットエンジンのバージョンと一致しません。 | 1. ターゲットのマイナーバージョンに適した CU KB 番号を特定します。2. 一致する CU バージョンで create-custom-db-engine-version を再試行します。 |
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. |
CEV 名にサポートされている文字のみを使用し、BYOM でサポートされている SQL Server のエディションまたはバージョンを使用していることを確認します。 | 1. サポートされているエンジン sqlserver-ee または sqlserver-se を使用していることを確認します。2. エンジンのバージョンが SQL Server 2019 (15.xx) または SQL Server 2022 (16.xx) であることを確認します。3. サポートされているエディションとバージョンで再試行します。 |
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. |
DB インスタンス、スナップショット、またはリードレプリカが、引き続き BYOM バージョンを使用しています。 | 1. このバージョンを使用しているリソースを特定します。aws rds describe-db-instances --query "DBInstances[?EngineVersion=='<version>']"。2. スナップショットを特定します。aws rds describe-db-snapshots --query "DBSnapshots[?EngineVersion=='<version>']"。3. インスタンスを別のバージョンに移行するか、削除します。4. 関連付けられたスナップショットと自動バックアップを削除します。5. 再試行。delete-custom-db-engine-version |
InvalidParameterCombination: The LicenseModel parameter is required for configurations with multiple options. |
BYOM はこのバージョンでアクティブ化されていますが、--license-model は除外されています。 |
コマンドに --license-model bring-your-own-media または --license-model license-included を追加します。 |
The combination of engine sqlserver-se and version <version> isn't valid. Enter a valid custom engine version, and try again. |
このエラーは、以下のいずれかの場合に発生します。(1) ターゲットエンジンバージョンに BYOM エンジンバージョンが存在しない。(2) ターゲット BYOM エンジンバージョンが incompatible-media または inactive ステータスである。(3) 指定されたエンジンバージョンがサポートされているメジャー/マイナーの組み合わせではない。 |
サポートされているエンジンバージョンを確認するには、まず describe-db-engine-versions を実行し、続いて create-custom-db-engine-version を使用して BYOM エンジンバージョンを作成します。 |
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. |
BYOM エンジンバージョンが検証に失敗した状態です。 | 失敗した BYOM エンジンバージョンを削除し、正しいインストールメディアを再アップロードして、新しい 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. |
指定されたインスタンスタイプは BYOM ではサポートされていません。 | インスタンスクラスが BYOM をサポートしているかどうかを確認するには、describe-orderable-db-instance-options API を使用します。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']"。または、サポートされているインスタンスクラスの Amazon RDS for SQL Server の料金ページ |
InvalidParameterCombination: The combination of engine and version isn't valid. Enter a valid custom engine version, and try again. の。ModifyDBInstance |
BYOM インスタンスをアップグレードするには、ターゲットバージョンの BYOM エンジンバージョンが存在し、少なくとも available ステータスである必要があります。以下のいずれかの場合、modify-db-instance 呼び出しは拒否されます。ターゲットエンジンバージョンに BYOM エンジンバージョンが存在しない場合、ターゲット BYOM エンジンバージョンが incompatible-media または inactive ステータスの場合、ターゲットバージョンが ValidUpgradeTarget 配列にない場合。 |
describe-db-engine-versions コマンドを使用して、有効なマイナーバージョンアップグレードターゲットを一覧表示します。BYOM インスタンスにマイナーバージョンアップグレードを適用する前に、ターゲットバージョンに有効な BYOM エンジンバージョンが存在することを確認します。存在しない場合は、作成して使用可能になるまで待機します。 |