BYOM 엔진 버전 및 DB 인스턴스 문제 해결

BYOM 엔진 버전 및 DB 인스턴스 문제 해결

Amazon RDS 사용자 가이드의 이 페이지를 한국어로 설명합니다.

출처: 문서

본문

BYOM 엔진 버전 및 DB 인스턴스 문제 해결

다음 표는 RDS for SQL Server용 BYOM(자체 미디어 가져오기) 엔진 버전 및 DB 인스턴스를 만들고 관리할 때 발생하는 일반적인 문제를 진단하고 해결하는 데 도움이 됩니다.

오류 메시지 / 증상 원인 권장 해결 방법
InvalidParameterValue: 제공된 .ISO 파일이 엔진 버전 15.00.4435.7.v1에 대한 예상 설치 프로그램 파일과 일치하지 않아 RDS가 사용자 지정 엔진 버전을 만들 수 없습니다. 업로드한 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가 S3 버킷의 지정된 설치 프로그램 파일에 액세스할 수 없습니다. 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가 사용자 지정 엔진 버전을 만들 수 없습니다. CU 파일이 대상 엔진 버전과 일치하지 않습니다. 1. 대상 마이너 버전에 대한 올바른 CU KB 번호를 식별합니다. 2. 일치하는 CU 버전으로 create-custom-db-engine-version을 다시 시도합니다.
InvalidParameterValue: 사용자 지정 엔진 버전이 유효하지 않습니다. 이름에는 소문자(a-z), 대시(-), 밑줄(_), 마침표(.)만 포함할 수 있습니다. 유효한 CEV를 지정하고 https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.create 을 참조한 후 다시 시도하세요. CEV 이름이 지원되는 문자만 사용하는지, BYOM 지원 SQL Server 에디션 또는 버전을 사용 중인지 확인하세요. 1. 지원되는 엔진(sqlserver-ee 또는 sqlserver-se)을 사용 중인지 확인합니다. 2. 엔진 버전이 SQL Server 2019(15.xx) 또는 SQL Server 2022(16.xx)인지 확인합니다. 3. 지원되는 에디션과 버전으로 다시 시도합니다.
InvalidCustomDBEngineVersionStateFault: 사용자 지정 엔진 버전 sqlserver-ee 15.00.4465.1.v1을 삭제할 수 없습니다. 최소 하나의 인스턴스와 백업이 CEV를 사용 중입니다. 버전을 변경하거나 인스턴스와 백업을 삭제한 후 다시 시도하세요. DB 인스턴스, 스냅샷 또는 읽기 복제본이 여전히 BYOM 버전을 사용 중입니다. 1. 이 버전을 사용하는 리소스를 식별합니다: aws rds describe-db-instances --query "DBInstances[?EngineVersion=='']". 2. 스냅샷을 식별합니다: aws rds describe-db-snapshots --query "DBSnapshots[?EngineVersion=='']". 3. 인스턴스를 다른 버전으로 마이그레이션하거나 삭제합니다. 4. 연결된 스냅샷과 자동 백업을 삭제합니다. 5. delete-custom-db-engine-version을 다시 시도합니다.
InvalidParameterCombination: 여러 옵션이 있는 구성에는 LicenseModel 파라미터가 필요합니다. 이 버전에 BYOM이 활성화되어 있지만 --license-model이 생략되었습니다. 명령에 --license-model bring-your-own-media 또는 --license-model license-included를 추가합니다.
엔진 sqlserver-se와 버전 의 조합이 유효하지 않습니다. 유효한 사용자 지정 엔진 버전을 입력하고 다시 시도하세요. 이 오류는 (1) 대상 엔진 버전에 대한 BYOM 엔진 버전이 없는 경우, (2) 대상 BYOM 엔진 버전이 incompatible-media 또는 inactive 상태인 경우, (3) 지정된 엔진 버전이 지원되지 않는 메이저/마이너 조합인 경우에 발생합니다. 지원되는 엔진 버전을 확인하려면 describe-db-engine-versions를 실행하고먼저 create-custom-db-engine-version으로 BYOM 엔진 버전을 만드세요.
InvalidParameterCombination: 사용자 지정 엔진 버전 이 incompatible-installation-media 상태이므로 RDS가 작업을 수행할 수 없습니다. 다음 상태 중 하나인 사용자 지정 엔진 버전을 선택하고 다시 시도하세요: available, creating, pending-validation, validating. BYOM 엔진 버전이 검증 상태에 실패했습니다. 실패한 BYOM 엔진 버전을 삭제하고 올바른 설치 미디어를 다시 업로드한 후 새 BYOM 엔진 버전을 만드세요.
InvalidParameterCombination: RDS가 다음 조합으로 DB 인스턴스 생성을 지원하지 않습니다: DBInstanceClass=<인스턴스 클래스>, Engine=<에디션>, EngineVersion=<버전>, LicenseModel=bring-your-own-media. 지원되는 인스턴스 클래스와 데이터베이스 엔진 버전 조합은 문서를 참조하세요. 지정한 인스턴스 유형이 BYOM에서 지원되지 않습니다. 인스턴스 클래스가 BYOM을 지원하는지 확인하려면 describe-orderable-db-instance-options API를 사용하세요: aws rds describe-orderable-db-instance-options --engine sqlserver-ee --engine-version --db-instance-class --region --query "OrderableDBInstanceOptions[?LicenseModel=='bring-your-own-media']". 또는 Amazon RDS for SQL Server 가격 책정 페이지에서 지원되는 인스턴스 클래스를 확인하세요.
InvalidParameterCombination: 엔진과 버전의 조합이 유효하지 않습니다. 유효한 사용자 지정 엔진 버전을 입력하고 다시 시도하세요. (ModifyDBInstance에서) BYOM 인스턴스를 업그레이드하려면 대상 버전에 대한 BYOM 엔진 버전이 존재해야 하며 최소한 available 상태여야 합니다. modify-db-instance 호출은 대상 엔진 버전에 대한 BYOM 엔진 버전이 없는 경우, 대상 BYOM 엔진 버전이 incompatible-media 또는 inactive 상태인 경우, 대상 버전이 ValidUpgradeTarget 배열에 없는 경우 거부됩니다. describe-db-engine-versions 명령을 사용하여 유효한 마이너 버전 업그레이드 대상을 나열하세요. BYOM 인스턴스에 마이너 버전 업그레이드를 적용하기 전에 대상 버전에 대한 유효한 BYOM 엔진 버전이 있는지 확인하세요. 없으면 만들고 available 상태가 될 때까지 기다리세요.

더 알아보기 (Learn more)