# RDS Custom for SQL Server 사용자 지정 엔진 버전 작업
RDS Custom for SQL Server용 *사용자 지정 엔진 버전(CEV)*은 Microsoft SQL Server가 포함된 Amazon Machine Image(AMI)입니다.
**CEV 워크플로의 기본 단계는 다음과 같습니다.**
1. CEV의 기본 이미지로 사용할 AWS EC2 Windows AMI를 선택합니다. 사전 설치된 Microsoft SQL Server를 사용하거나 자체 미디어를 가져와 SQL Server를 직접 설치할 수 있습니다.
1. 운영 체제(OS)에 다른 소프트웨어를 설치하고 기업 요구 사항에 맞게 OS 및 SQL Server의 구성을 사용자 지정합니다.
1. AMI를 골든 이미지로 저장
1. 골든 이미지로 커스텀 엔진 버전(CEV)을 만듭니다.
1. CEV를 사용하여 새 RDS Custom for SQL Server DB 인스턴스를 생성합니다.
이렇게 하면 Amazon RDS가 사용자를 대신해 이러한 DB 인스턴스를 관리합니다.
CEV를 사용하면 OS와 데이터베이스의 기본 구성을 원하는 대로 유지할 수 있습니다. CEV를 사용하면 타사 에이전트 설치 또는 기타 OS 사용자 지정 같은 호스트 구성이 RDS Custom for SQL Server DB 인스턴스에서 유지됩니다. CEV를 사용하면 동일한 구성의 RDS Custom for SQL Server DB 플릿을 빠르게 배포할 수 있습니다.
**Topics**
+ [RDS Custom for SQL Server용 CEV 생성 준비](custom-cev-sqlserver.preparing.md)
+ [RDS Custom for SQL Server CEV 생성](custom-cev-sqlserver.create.md)
+ [RDS Custom for SQL Server용 CEV 수정](custom-cev-sqlserver-modifying.md)
+ [Amazon RDS Custom for SQL Server의 CEV 세부 정보 보기](custom-viewing-sqlserver.md)
+ [RDS Custom for SQL Server용 CEV 삭제](custom-cev-sqlserver-deleting.md)
# RDS Custom for SQL Server용 CEV 생성 준비
사전 설치된 라이선스 포함(LI) Microsoft SQL Server가 속한 Amazon Machine Image(AMI)를 사용하거나 자체 SQL Server 설치 미디어(BYOM)가 설치될 AMI를 사용하여 CEV를 생성할 수 있습니다.
## CEV 준비
다음 절차에 따라 기존 보유 미디어 사용(BYOM) 또는 사전 설치된 Microsoft SQL Server(LI)를 사용하여 CEV를 생성합니다.
### 기존 보유 미디어를 사용(BYOM)하여 CEV 준비
다음 단계에서는 **Windows Server 2019 Base**가 포함된 AMI를 예로 사용합니다.
**BYOM을 사용하여 CEV를 만드는 방법**
1. Amazon EC2 콘솔 대시보드에서 **인스턴스 시작**을 선택합니다.
1. **이름**에 인스턴스 이름을 입력합니다.
1. 빠른 시작에서 **Windows**를 선택합니다.
1. **Microsoft Windows Server 2019 Base**를 선택합니다.
1. 적절한 인스턴스 유형, 키 페어, 네트워크 및 스토리지 설정을 선택하고 인스턴스를 시작합니다.
1. EC2 인스턴스를 시작하거나 생성한 후 4단계에서 올바른 Windows AMI를 선택했는지 확인합니다.
1. Amazon EC2 콘솔에서 EC2 인스턴스를 선택합니다.
1. **세부 정보** 섹션에서 **사용 작업**을 확인하고 해당 작업이 **RunInstances:0002**로 설정되어 있는지 확인합니다.
![\[BYOM용 RunInstances:0002를 사용하는 Windows AMI입니다.\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/cev-sqlserver-byom-ec2runinstances.png)
1. EC2 인스턴스에 로그인하고 SQL Server 설치 미디어를 해당 인스턴스에 복사합니다.
**참고**
SQL Server Developer 에디션을 사용하여 CEV를 구축하는 경우 [Microsoft Visual Studio 구독](https://my.visualstudio.com/Downloads?q=sqlserver%20developer)을 사용하여 설치 미디어를 구해야 할 수 있습니다.
1. SQL Server를 설치합니다. 다음을 수행하세요.
1. [RDS Custom for SQL Server에서 BYOM 사용 시 요구 사항](custom-sqlserver.byom.md#custom-sqlserver.byom.requirements) 및 [RDS Custom for SQL Server CEV에 대한 버전 지원](#custom-cev-sqlserver.preparing.VersionSupport)를 검토합니다.
1. 인스턴스 루트 디렉터리를 기본값인 `C:\Program Files\Microsoft SQL Server\`로 설정합니다. 이 디렉터리를 변경하지 마세요.
1. SQL Server 데이터베이스 엔진 계정 이름을 `NT Service\MSSQLSERVER` 또는 `NT AUTHORITY\NETWORK SERVICE`로 설정합니다.
1. SQL Server 시작 모드를 **수동**으로 설정합니다.
1. SQL Server 인증 모드를 **혼합**으로 선택합니다.
1. 기본 데이터 디렉터리 및 TempDB 위치에 대한 기존 설정을 그대로 유지합니다.
1. SQL Server 시스템 관리자(SA) 서버 역할 권한을 `NT AUTHORITY\SYSTEM`에 부여합니다.
```
1. USE [master]
2. GO
3. EXEC master..sp_addsrvrolemember @loginame = N'NT AUTHORITY\SYSTEM' , @rolename = N'sysadmin'
4. GO
```
1. 추가 소프트웨어를 설치하거나 요구 사항에 맞게 OS 및 데이터베이스 구성을 사용자 지정합니다.
1. EC2 인스턴스에서 Sysprep을 실행합니다. 자세한 내용은 [Create an Amazon EC2 AMI using Windows Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html)을 참조하세요.
1. 설치된 SQL Server 버전, 기타 소프트웨어 및 사용자 지정이 포함된 AMI를 저장합니다. 이것이 골든 이미지가 됩니다.
1. 생성한 이미지의 AMI ID를 제공하여 새 CEV를 생성합니다. 자세한 단계는 [RDS Custom for SQL Server CEV 생성](custom-cev-sqlserver.create.md) 섹션을 참조하세요.
1. CEV를 사용하여 새 RDS Custom for SQL Server DB 인스턴스를 생성합니다. 자세한 단계는 [CEV에서 RDS Custom for SQL Server DB 인스턴스 생성](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance) 섹션을 참조하세요.
### 사전 설치된 SQL Server(LI)를 사용하여 CEV 준비
사전 설치된 Microsoft SQL Server(LI)를 사용하여 CEV를 생성하는 다음 단계에서는 **SQL Server CU20** 릴리스 번호가 `2023.05.10`인 AMI를 예로 사용합니다. CEV를 생성할 때는 릴리스 번호가 가장 최신인 AMI를 선택하세요. 이렇게 하면 지원되는 버전의 Windows Server 및 SQL Server를 최신 누적 업데이트(CU)와 함께 사용할 수 있습니다.
**사전 설치된 Microsoft SQL Server(LI)를 사용하여 CEV를 만드는 방법**
1. 라이선스 포함(LI) Microsoft Windows Server 및 SQL Server가 있는 최신 AWS EC2 Windows Amazon Machine Image(AMI)를 선택합니다.
1. [Windows AMI 버전 기록](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-windows-ami-version-history.html)에서 **CU20**을 검색합니다.
1. 릴리스 번호를 기록해 두세요. SQL Server 2019 CU20의 릴리스 번호는 `2023.05.10`입니다.
![\[SQL Server 2019 CU20에 대한 AMI 버전 기록 결과.\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_history_li_cu20.png)
1. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)에서 Amazon EC2 콘솔을 엽니다.
1. Amazon EC2 콘솔의 왼쪽 탐색 창에서 **Images**(이미지)를 선택하고 **AMIs**를 선택합니다.
1. **퍼블릭 이미지**를 선택합니다.
1. 검색 상자에 `2023.05.10`를 입력합니다. AMI 목록이 나타납니다.
1. 검색 상자에 `Windows_Server-2019-English-Full-SQL_2019`를 입력하여 결과를 필터링합니다. 다음과 같은 결과가 표시됩니다.
![\[SQL Server 2019 CU20을 사용하는 지원되는 AMI.\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_li_cu.png)
1. 사용할 SQL Server 에디션이 있는 AMI를 선택합니다.
1. 선택한 AMI에서 EC2 인스턴스를 생성하거나 시작합니다.
1. EC2 인스턴스에 로그인하여 추가 소프트웨어를 설치하거나 요구 사항에 맞게 OS 및 데이터베이스 구성을 사용자 지정합니다.
1. EC2 인스턴스에서 Sysprep을 실행합니다. Sysprep을 사용한 AMI 준비에 대한 자세한 내용은 [Sysprep을 사용하여 표준화된 Amazon Machine Image(AMI) 생성](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#sysprep-using-ec2launchv2)을 참조하세요.
1. 설치된 SQL Server 버전, 기타 소프트웨어 및 사용자 지정이 포함된 AMI를 저장합니다. 이것이 골든 이미지가 됩니다.
1. 생성한 이미지의 AMI ID를 제공하여 새 CEV를 생성합니다. CEV 생성에 대한 자세한 단계는 [RDS Custom for SQL Server CEV 생성](custom-cev-sqlserver.create.md) 섹션을 참조하세요.
1. CEV를 사용하여 새 RDS Custom for SQL Server DB 인스턴스를 생성합니다. 자세한 단계는 [CEV에서 RDS Custom for SQL Server DB 인스턴스 생성](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance) 섹션을 참조하세요.
## RDS Custom for SQL Server CEV에 대한 리전 가용성
RDS Custom for SQL Server에 대한 사용자 지정 엔진 버전(CEV) 지원은 다음 AWS 리전에서 제공됩니다.
+ 미국 동부(오하이오)
+ 미국 동부(버지니아 북부)
+ 미국 서부(오레곤)
+ 미국 서부(캘리포니아 북부)
+ 아시아 태평양(뭄바이)
+ 아시아 태평양(오사카)
+ 아시아 태평양(서울)
+ 아시아 태평양(싱가포르)
+ 아시아 태평양(시드니)
+ 아시아 태평양(도쿄)
+ 캐나다(중부)
+ 유럽(프랑크푸르트)
+ 유럽(아일랜드)
+ 유럽(런던)
+ 유럽(파리)
+ 유럽(스톡홀름)
+ 남아메리카(상파울루)
## RDS Custom for SQL Server CEV에 대한 버전 지원
RDS Custom for SQL Server용 CEV 생성은 다음 AWS EC2 Windows AMI에서 지원됩니다.
+ 사전 설치된 미디어를 사용하는 CEV의 경우 라이선스 포함(LI) Microsoft Windows Server 2019(OS) 및 SQL Server 2022 또는 2019가 포함된 AWS EC2 Windows AMI
+ 기존 보유 미디어를 사용(BYOM)하는 CEV의 경우 Microsoft Windows Server 2019(OS)가 포함된 AWS EC2 Windows AMI
RDS Custom for SQL Server용 CEV 생성은 다음 운영 체제(OS) 및 데이터베이스 에디션에 지원됩니다.
+ 사전 설치된 미디어를 사용하는 CEV의 경우:
+ SQL Server 2,022 Enterprise, Standard 또는 Web과 CU9, CU13, CU14-GDR, CU15-GDR, CU16, CU17, CU18, CU19, CU19-GDR, CU20-GDR, CU21-GDR, CU22 및 CU22-GDR.
+ SQL Server 2019 Enterprise, Standard 또는 Web과 CU8, CU17, CU18, CU20, CU24, CU26, CU28-GDR, CU29-GDR, CU30, CU32 및 CU32-GDR.
+ 기존 보유 미디어를 사용(BYOM)하는 CEV의 경우:
+ SQL Server 2022 Enterprise, Standard 또는 Developer와 CU9, CU13, CU14-GDR, CU15-GDR, CU16, CU17, CU18, CU19, CU19-GDR, CU20-GDR, CU21-GDR, CU22 및 CU22-GDR.
+ SQL Server 2019 Enterprise, Standard 또는 Developer와 CU8, CU17, CU18, CU20, CU24, CU26, CU28-GDR, CU29-GDR, CU30, CU32 및 CU32-GDR.
+ 사전 설치된 미디어 또는 기존 보유 미디어를 사용(BYOM)하는 CEV의 경우 OS로 Windows Server 2019가 유일하게 지원됨
자세한 내용은 [AWS Windows AMI 버전 기록](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html)을 참조하세요.
## RDS Custom for SQL Server CEV 요구 사항
다음 요구 사항은 RDS Custom for SQL Server용 CEV 생성에 적용됩니다.
+ CEV를 생성하는 데 사용하는 AMI는 RDS Custom for SQL Server에서 지원하는 OS 및 데이터베이스 구성을 기반으로 해야 합니다. 지원되는 구성에 대한 자세한 내용은 [Amazon RDS Custom for SQL Server 요구 사항 및 제한](custom-reqs-limits-MS.md) 섹션을 참조하세요.
+ CEV에는 고유한 이름이 있어야 합니다. 기존 CEV와 이름이 같은 CEV는 생성할 수 없습니다.
+ SQL Server *메이저 버전 \$1 마이너 버전 \$1 사용자 지정 문자열*이라는 이름 지정 패턴을 사용하여 CEV 이름을 지정해야 합니다. *메이저 버전\$1마이너 버전*은 AMI와 함께 제공된 SQL Server 버전과 일치해야 합니다. 예를 들어 SQL Server 2019 CU17을 사용하는 AMI의 이름은 **15.00.4249.2.my\$1cevtest**로 지정할 수 있습니다.
+ Sysprep을 사용한 AMI를 준비해야 합니다. Sysprep을 사용한 AMI 준비에 대한 자세한 내용은 [Sysprep을 사용하여 표준화된 Amazon Machine Image(AMI) 생성](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html)을 참조하세요.
+ AMI의 수명 주기를 관리할 책임은 사용자에게 있습니다. CEV에서 생성된 RDS Custom for SQL Server DB 인스턴스에는 AMI 사본이 저장되지 않습니다. CEV를 생성하는 데 사용한 AMI에 대한 포인터를 유지합니다. RDS Custom for SQL Server DB 인스턴스가 계속 작동하려면 AMI가 있어야 합니다.
## RDS Custom for SQL Server CEV 제한 사항
RDS Custom for SQL Server를 사용하는 사용자 지정 엔진 버전에는 다음과 같은 제한 사항이 적용됩니다.
+ 연결된 DB 인스턴스 또는 DB 스냅샷 같은 리소스가 있는 경우 CEV를 삭제할 수 없습니다.
+ RDS Custom for SQL Server DB 인스턴스를 생성하려면 CEV는 상태가 `pending-validation`, `available`, `failed` 또는 `validating`이어야 합니다. CEV 상태가 `incompatible-image-configuration`인 경우에는 CEV를 사용하여 RDS Custom for SQL Server DB 인스턴스를 생성할 수 없습니다.
+ 새 CEV를 사용하도록 RDS Custom for SQL Server DB 인스턴스를 수정하려면 CEV 상태가 `available`이어야 합니다.
+ 기존 RDS Custom for SQL Server DB 인스턴스에서 AMI 또는 CEV를 생성할 수 없습니다.
+ 다른 AMI를 사용하도록 기존 CEV를 수정할 수는 없습니다. 그러나 RDS Custom for SQL Server DB 인스턴스를 수정하여 다른 CEV를 사용할 수는 있습니다. 자세한 내용은 [RDS Custom for SQL Server DB 인스턴스 수정](custom-managing.modify-sqlserver.md) 섹션을 참조하세요.
+ DB 인스턴스 생성 중에 제공된 KMS 키와 다른 고객 관리형 KMS 키로 AMI 또는 CEV를 암호화하는 것은 지원되지 않습니다.
+ CEV의 교차 리전 복사는 지원되지 않습니다.
+ CEV의 교차 계정 복사는 지원되지 않습니다.
+ 삭제한 CEV는 복원 또는 복구할 수 없습니다. 하지만 동일한 AMI에서 새 CEV를 생성할 수 있습니다.
+ RDS Custom for SQL Server DB 인스턴스는 SQL Server 데이터베이스 파일을 *D:\$1* 드라이브에 저장합니다. CEV와 연결된 AMI는 Microsoft SQL Server 시스템 데이터베이스 파일을 *C:\$1* 드라이브에 저장해야 합니다.
+ RDS Custom for SQL Server DB 인스턴스는 SQL Server 구성 변경 사항을 유지합니다. CEV에서 생성한 RDS Custom for SQL Server DB 인스턴스에서 실행 중인 운영 체제의 구성 변경 사항은 유지되지 않습니다. OS의 구성을 영구적으로 변경하고 이를 새 기본 구성으로 유지해야 하는 경우, 새 CEV를 생성한 다음 새 CEV를 사용하도록 DB 인스턴스를 수정하십시오.
**중요**
새 CEV를 사용하도록 RDS Custom for SQL Server DB 인스턴스를 수정하는 작업은 오프라인 작업입니다. 즉시 수정을 수행하거나 주간 유지 관리 기간 중에 수정하도록 예약할 수 있습니다.
+ CEV를 수정할 때 Amazon RDS는 해당 수정 사항을 관련 RDS Custom for SQL Server DB 인스턴스에 푸시하지 않습니다. 신규 또는 업데이트된 CEV를 사용하려면 각 RDS Custom for SQL Server DB 인스턴스를 수정해야 합니다. 자세한 내용은 [RDS Custom for SQL Server DB 인스턴스 수정](custom-managing.modify-sqlserver.md) 섹션을 참조하세요.
+
**중요**
CEV에서 사용하는 AMI가 삭제되면 호스트 교체가 필요할 수 있는 모든 수정(예: 컴퓨팅 크기 조정)이 실패하게 됩니다. 이렇게 되면 RDS Custom for SQL Server DB 인스턴스가 RDS 지원 경계 외부에 배치됩니다. CEV와 연결된 AMI는 삭제하지 않는 것이 좋습니다.
# RDS Custom for SQL Server CEV 생성
AWS Management Console 또는 AWS CLI를 사용하여 사용자 지정 엔진 버전(CEV)을 생성할 수 있습니다. 그런 다음 CEV를 사용하여 RDS Custom for SQL Server DB 인스턴스를 생성할 수 있습니다.
Amazon Machine Image(AMI)가 CEV와 동일한 AWS 계정 및 리전에 있는지 확인합니다. 그렇지 않으면 CEV 생성 프로세스가 실패합니다.
자세한 내용은 [Amazon RDS Custom for SQL Server의 DB 인스턴스 생성 및 연결](custom-creating-sqlserver.md) 단원을 참조하십시오.
**중요**
CEV를 만드는 단계는 사전 설치된 SQL Server로 만든 AMI 및 기존 보유 미디어를 사용(BYOM)하여 만든 AMI와 동일합니다.
## 콘솔
**CEV를 생성하는 방법**
1. [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 AWS Management Console에 로그인한 후 Amazon RDS 콘솔을 엽니다.
1. 탐색 창에서 **사용자 지정 엔진 버전(Custom engine versions)**을 선택합니다.
**사용자 지정 엔진 버전(Custom engine versions)** 페이지에는 현재 존재하는 모든 CEV가 표시됩니다. CEV를 생성하지 않았다면 테이블은 비어 있습니다.
1. **Create custom engine version**(사용자 지정 엔진 버전 생성)을 선택합니다.
1. **Engine type**(엔진 유형)에서 **Microsoft SQL Server**를 선택합니다.
1. **에디션**에서 사용할 DB 엔진 에디션을 선택합니다.
1. **Major version**(메이저 버전)에서 AMI에 설치된 메이저 엔진 버전을 선택합니다.
1. **버전 세부 정보(Version details)**의 **사용자 지정 엔진 버전 이름(Custom engine version name)**에 유효한 이름을 입력합니다.
이름 형식은 `major-engine-version.minor-engine-version.customized_string`입니다. 1\$150개의 영숫자, 밑줄, 대시 및 마침표를 사용할 수 있습니다. 예를 들어, **15.00.4249.2.my\$1cevtest**을 이름으로 입력할 수 있습니다.
필요에 따라 CEV에 대한 설명을 입력합니다.
1. **Installation Media**(설치 미디어)에서 CEV를 생성할 때 사용할 AMI ID를 찾거나 입력합니다.
1. **Tags**(태그) 섹션에서 CEV를 식별하는 태그를 추가합니다.
1. **Create custom engine version**(사용자 지정 엔진 버전 생성)을 선택합니다.
**사용자 지정 엔진 버전(Custom engine versions)** 페이지가 표시됩니다. CEV가 **pending-validation**(검증 보류 중) 상태로 표시됩니다.
## AWS CLI
AWS CLI를 사용하여 CEV를 생성하려면 [create-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html) 명령을 실행합니다.
다음 옵션이 필요합니다.
+ `--engine`
+ `--engine-version`
+ `--image-id`
다음 옵션도 지정할 수 있습니다.
+ `--description`
+ `--region`
+ `--tags`
다음 예제에서는 `15.00.4249.2.my_cevtest`이라는 CEV를 생성합니다. CEV의 이름이 주요 엔진 버전 번호로 시작하는지 확인하세요.
**Example**
대상 LinuxmacOS, 또는Unix:
```
1. aws rds create-custom-db-engine-version \
2. --engine custom-sqlserver-ee \
3. --engine-version 15.00.4249.2.my_cevtest \
4. --image-id ami-0r93cx31t5r596482 \
5. --description "Custom SQL Server EE 15.00.4249.2 cev test"
```
다음 부분 출력은 엔진, 파라미터 그룹 및 기타 정보를 보여줍니다.
```
1. "DBEngineVersions": [
2. {
3. "Engine": "custom-sqlserver-ee",
4. "MajorEngineVersion": "15.00",
5. "EngineVersion": "15.00.4249.2.my_cevtest",
6. "DBEngineDescription": "Microsoft SQL Server Enterprise Edition for RDS Custom for SQL Server",
7. "DBEngineVersionArn": "arn:aws:rds:us-east-1::cev:custom-sqlserver-ee/15.00.4249.2.my_cevtest/a1234a1-123c-12rd-bre1-1234567890",
8. "DBEngineVersionDescription": "Custom SQL Server EE 15.00.4249.2 cev test",
9.
10. "Image": [
11. "ImageId": "ami-0r93cx31t5r596482",
12. "Status": "pending-validation"
13. ],
14. "CreateTime": "2022-11-20T19:30:01.831000+00:00",
15. "SupportsLogExportsToCloudwatchLogs": false,
16. "SupportsReadReplica": false,
17. "Status": "pending-validation",
18. "SupportsParallelQuery": false,
19. "SupportsGlobalDatabases": false,
20. "TagList": []
21. }
22. ]
```
CEV 생성 프로세스가 실패하면 RDS Custom for SQL Server가 `Creation failed for custom engine version major-engine-version.cev_name` 메시지와 함께 `RDS-EVENT-0198`을 발급합니다. 메시지에는 실패(예: 이벤트가 누락된 파일 인쇄) 관련 세부 정보가 포함되어 있습니다. CEV 생성 문제 해결 아이디어를 찾으려면 [RDS Custom for SQL Server의 CEV 오류 문제 해결](custom-troubleshooting-sqlserver.md#custom-troubleshooting-sqlserver.cev) 단원을 참조하세요.
## CEV에서 RDS Custom for SQL Server DB 인스턴스 생성
CEV를 성공적으로 생성하면 **CEV status**(CEV 상태)에 `pending-validation`이 표시됩니다. 이제 CEV를 사용하여 새 RDS Custom for SQL Server DB 인스턴스를 생성할 수 있습니다. CEV에서 새 RDS Custom for SQL Server DB 인스턴스를 생성하려면 [RDS Custom for SQL Server DB 인스턴스 생성](custom-creating-sqlserver.md#custom-creating-sqlserver.create) 단원을 참조하세요.
## CEV의 수명 주기
CEV 수명 주기에는 다음 상태가 포함됩니다.
****
| CEV 상태 | 설명 | 문제 해결 제안 |
| --- | --- | --- |
| `pending-validation` | CEV가 생성되었고 연결된 AMI의 검증이 보류 중입니다. CEV는 RDS Custom for SQL Server DB 인스턴스가 생성될 때까지 `pending-validation` 상태를 유지됩니다. | 기존 작업이 없는 경우 CEV에서 새 RDS Custom for SQL Server DB 인스턴스를 생성하세요. RDS Custom for SQL Server DB 인스턴스를 생성할 때 시스템은 CEV에 연결된 AMI 검증을 시도합니다. |
| `validating` | 새 CEV를 기반으로 하는 RDS Custom for SQL Server DB 인스턴스의 생성 작업이 진행 중입니다. RDS Custom for SQL Server DB 인스턴스를 생성할 때 시스템은 CEV의 연결된 AMI를 검증하려고 합니다. | RDS Custom for SQL Server DB 인스턴스 생성 작업이 완료될 때까지 기다리세요. RDS EVENTS 콘솔을 사용하여 문제 해결을 위한 세부 이벤트 메시지를 검토할 수 있습니다. |
| `available` | CEV가 성공적으로 검증되었습니다. CEV에서 RDS Custom for SQL Server DB 인스턴스가 성공적으로 생성되면 CEV가 `available` 상태가 됩니다. | CEV는 추가 검증을 하지 않아도 됩니다. CEV는 RDS Custom for SQL Server DB 인스턴스를 추가로 생성하거나 기존 인스턴스를 수정하는 데 사용할 수 있습니다. |
| `inactive` | CEV가 비활성 상태로 수정되었습니다. | 이 CEV에서는 RDS Custom DB 인스턴스를 생성하거나 업그레이드할 수 없습니다. 또한 이 CEV에서는 DB 스냅샷을 복원하여 새로운 RDS Custom DB 인스턴스를 생성할 수 없습니다. 상태를 `ACTIVE`로 변경하는 방법에 대한 자세한 내용은 [RDS Custom for SQL Server용 CEV 수정](custom-cev-sqlserver-modifying.md) 단원을 참조하세요. |
| `failed` | AMI를 검증하기 전에 이 CEV의 DB 인스턴스 생성 단계가 실패했습니다. 또는 CEV에서 사용하는 기본 AMI가 사용 가능한 상태가 아닙니다. | 시스템에서 DB 인스턴스를 생성할 수 없는 근본 원인을 해결하세요. 자세한 오류 메시지를 확인하고 새 DB 인스턴스를 다시 생성해 보세요. CEV에서 사용하는 기본 AMI가 사용 가능한 상태인지 확인하세요. |
| `incompatible-image-configuration` | AMI를 검증하는 중 오류가 발생했습니다. | 오류의 기술적 세부 정보를 확인하세요. 이 CEV를 사용하여 AMI를 다시 검증할 수는 없습니다. 다음을 검토하세요. 권장 사항: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/custom-cev-sqlserver.create.html) 올바른 정보를 사용하여 새 CEV를 생성합니다. 필요한 경우 지원되는 AMI를 사용하여 새 EC2 인스턴스를 생성하고 이 인스턴스에서 Sysprep 프로세스를 실행합니다. |
# RDS Custom for SQL Server용 CEV 수정
AWS Management Console 또는 AWS CLI를 사용하여 CEV를 수정하고, CEV 설명 또는 가용 상태를 수정할 수 있습니다. CEV는 다음 상태 값 중 하나를 가집니다.
+ `available` - 이 CEV를 사용하여 새로운 RDS Custom DB 인스턴스를 생성하거나 DB 인스턴스를 업그레이드할 수 있습니다. 이 상태는 새로 생성된 CEV의 기본 상태입니다.
+ `inactive` - 이 CEV에서는 RDS Custom DB 인스턴스를 생성하거나 업그레이드할 수 없습니다. 이 CEV에서는 DB 스냅샷을 복원하여 새로운 RDS Custom DB 인스턴스를 생성할 수 없습니다.
CEV 상태를 `available`에서 `inactive`로, 또는 `inactive`에서 `available`로 변경할 수 있습니다. 상태를 `INACTIVE`로 변경하면 CEV를 실수로 사용하는 일을 방지하고 중단된 CEV를 다시 사용할 수 있습니다.
## 콘솔
**CEV를 수정하는 방법**
1. [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 AWS Management Console에 로그인한 후 Amazon RDS 콘솔을 엽니다.
1. 탐색 창에서 **사용자 지정 엔진 버전(Custom engine versions)**을 선택합니다.
1. 수정하려는 설명 또는 상태가 지정된 CEV를 선택합니다.
1. **작업**에서 **수정**을 선택합니다.
1. 다음을 원하는 대로 변경합니다.
+ **CEV 상태 설정(CEV status settings)**에서 새로운 가용 상태를 선택합니다.
+ **버전 설명(Version description)**에 새로운 설명을 입력합니다.
1. **CEV 수정(Modify CEV)**을 선택합니다.
CEV가 사용 중인 경우 콘솔에 **CEV 상태를 수정할 수 없습니다(You can't modify the CEV status)**가 표시됩니다. 문제를 해결한 후 다시 시도하세요.
**사용자 지정 엔진 버전(Custom engine versions)** 페이지가 표시됩니다.
## AWS CLI
AWS CLI를 사용하여 CEV를 수정하려면 [modify-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html) 명령을 실행합니다. [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) 명령을 실행하여 수정할 CEV를 찾을 수 있습니다.
다음 옵션이 필요합니다.
+ `--engine`
+ `--engine-version cev`(*`cev`*는 수정하려는 사용자 지정 엔진 버전의 이름)
+ `--status`` status`(*`status`*는 CEV에 할당하려는 가용 상태)
다음 예제에서는 이름이 `15.00.4249.2.my_cevtest`로 지정된 CEV를 현재 상태에서 `inactive`로 변경합니다.
**Example**
대상 LinuxmacOS, 또는Unix:
```
1. aws rds modify-custom-db-engine-version \
2. --engine custom-sqlserver-ee \
3. --engine-version 15.00.4249.2.my_cevtest \
4. --status inactive
```
Windows의 경우:
```
1. aws rds modify-custom-db-engine-version ^
2. --engine custom-sqlserver-ee ^
3. --engine-version 15.00.4249.2.my_cevtest ^
4. --status inactive
```
새 CEV를 사용하도록 RDS Custom for SQL Server DB 인스턴스를 수정하려면 [새 CEV를 사용하도록 RDS Custom for SQL Server DB 인스턴스 수정](custom-cev-sqlserver-modifying-dbinstance.md) 섹션을 참조하세요.
# 새 CEV를 사용하도록 RDS Custom for SQL Server DB 인스턴스 수정
기존 RDS Custom for SQL Server DB 인스턴스를 수정하여 다른 CEV를 사용할 수 있습니다. 다음과 같은 변경을 적용할 수 있습니다.
+ CEV 변경
+ DB 인스턴스 클래스 변경
+ 백업 보존 기간 및 백업 기간 변경
+ 유지 관리 기간 변경
## 콘솔
**RDS Custom for SQL Server DB 인스턴스를 수정하는 방법**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon RDS 콘솔을 엽니다.
1. 탐색 창에서 **데이터베이스**를 선택합니다.
1. 수정하려는 DB 인스턴스를 선택합니다.
1. **Modify**(수정)를 선택합니다.
1. 필요에 따라 다음과 같이 변경합니다.
1. **DB 엔진 버전**(DB engine version)에서 다른 CEV를 선택합니다.
1. **DB 인스턴스 클래스(DB instance class)** 값을 변경합니다. 지원되는 클래스는 [RDS Custom for SQL Server DB 인스턴스 클래스 지원](custom-reqs-limits.instancesMS.md) 섹션을 참조하세요.
1. **백업 보존 기간(Backup retention period)** 값을 변경합니다.
1. **백업 기간(Backup window)**의 경우 **시작 시간(Start time)**과 **기간(Duration)** 값을 설정합니다.
1. **DB 인스턴스 유지 관리 기간(DB instance maintenance window)**의 경우 **시작일(Start day)**, **시작 시간(Start time)**, **기간(Duration)** 값을 설정합니다.
1. **계속(Continue)**을 선택합니다.
1. **즉시 적용(Apply immediately)** 또는 **예약된 다음 유지 관리 기간에 적용(Apply during the next scheduled maintenance window)**을 선택합니다.
1. **Modify DB instance**(DB 인스턴스 수정)를 선택합니다.
**참고**
특정 CEV의 DB 인스턴스를 다른 CEV로 수정하는 경우(예를 들어 마이너 버전 업그레이드를 하는 경우), SQL Server 시스템 데이터베이스와 관련 데이터 및 구성은 현재 RDS Custom for SQL Server DB 인스턴스의 항목이 그대로 유지됩니다.
## AWS CLI
AWS CLI로 DB 인스턴스를 수정해 다른 CEV를 사용할 수 있게 하려면 [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html) 명령을 실행합니다.
다음 옵션이 필요합니다.
+ `--db-instance-identifier`
+ `--engine-version cev`(*`cev`*는 DB 인스턴스의 변경 대상인 사용자 지정 엔진 버전의 이름입니다).
다음 예제에서는 `my-cev-db-instance`라는 이름의 CEV를 사용하도록 `15.00.4249.2.my_cevtest_new`라는 이름의 DB 인스턴스를 수정하고 변경 사항을 즉시 적용합니다.
**Example**
대상 LinuxmacOS, 또는Unix:
```
1. aws rds modify-db-instance \
2. --db-instance-identifier my-cev-db-instance \
3. --engine-version 15.00.4249.2.my_cevtest_new \
4. --apply-immediately
```
Windows의 경우:
```
1. aws rds modify-db-instance ^
2. --db-instance-identifier my-cev-db-instance ^
3. --engine-version 15.00.4249.2.my_cevtest_new ^
4. --apply-immediately
```
# Amazon RDS Custom for SQL Server의 CEV 세부 정보 보기
AWS Management Console 또는 AWS CLI를 사용하여 CEV에 대한 세부 정보를 볼 수 있습니다.
## 콘솔
**CEV 세부 정보를 보려면**
1. [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 AWS Management Console에 로그인한 후 Amazon RDS 콘솔을 엽니다.
1. 탐색 창에서 **사용자 지정 엔진 버전(Custom engine versions)**을 선택합니다.
**사용자 지정 엔진 버전(Custom engine versions)** 페이지에는 현재 존재하는 모든 CEV가 표시됩니다. CEV를 생성한 적이 없으면 페이지가 비어 있습니다.
1. 보려는 CEV의 이름을 선택합니다.
1. 세부 정보를 보려면 **Configuration**(구성)을 선택합니다.
![\[CEV의 구성 세부 정보를 봅니다.\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_viewdetails.PNG)
## AWS CLI
AWS CLI를 사용하여 CEV에 대한 세부 정보를 보려면 [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) 명령을 실행합니다.
다음 옵션도 지정할 수 있습니다.
+ `--include-all`, 수명 주기 상태가 있는 모든 CEV를 볼 수 있습니다. `--include-all` 옵션이 없으면 `available` 수명 주기 상태의 CEV만 반환됩니다.
```
aws rds describe-db-engine-versions --engine custom-sqlserver-ee --engine-version 15.00.4249.2.my_cevtest --include-all
{
"DBEngineVersions": [
{
"Engine": "custom-sqlserver-ee",
"MajorEngineVersion": "15.00",
"EngineVersion": "15.00.4249.2.my_cevtest",
"DBParameterGroupFamily": "custom-sqlserver-ee-15.0",
"DBEngineDescription": "Microsoft SQL Server Enterprise Edition for custom RDS",
"DBEngineVersionArn": "arn:aws:rds:us-east-1:{my-account-id}:cev:custom-sqlserver-ee/15.00.4249.2.my_cevtest/a1234a1-123c-12rd-bre1-1234567890",
"DBEngineVersionDescription": "Custom SQL Server EE 15.00.4249.2 cev test",
"Image": {
"ImageId": "ami-0r93cx31t5r596482",
"Status": "pending-validation"
},
"DBEngineMediaType": "AWS Provided",
"CreateTime": "2022-11-20T19:30:01.831000+00:00",
"ValidUpgradeTarget": [],
"SupportsLogExportsToCloudwatchLogs": false,
"SupportsReadReplica": false,
"SupportedFeatureNames": [],
"Status": "pending-validation",
"SupportsParallelQuery": false,
"SupportsGlobalDatabases": false,
"TagList": [],
"SupportsBabelfish": false
}
]
}
```
필터를 사용하여 특정 수명 주기 상태의 CEV를 볼 수 있습니다. 예를 들어 수명 주기 상태가 `pending-validation`, `available` 또는 `failed`인 CEV를 볼 수 있습니다.
```
aws rds describe-db-engine-versions engine custom-sqlserver-ee
region us-west-2 include-all query 'DBEngineVersions[?Status == pending-validation ||
Status == available || Status == failed]'
```
# RDS Custom for SQL Server용 CEV 삭제
AWS Management Console 또는 AWS CLI를 사용하여 CEV를 삭제할 수 있습니다. 이 작업은 일반적으로 몇 분 정도 걸립니다.
CEV를 삭제하기 전에 CEV가 다음 중 하나에 속하지 않는지 확인하세요.
+ RDS Custom DB 인스턴스
+ RDS Custom DB 인스턴스의 스냅샷
+ RDS Custom DB 인스턴스의 자동 백업
## 콘솔
**CEV를 삭제하는 방법**
1. [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 AWS Management Console에 로그인한 후 Amazon RDS 콘솔을 엽니다.
1. 탐색 창에서 **사용자 지정 엔진 버전(Custom engine versions)**을 선택합니다.
1. 삭제하려는 설명 또는 상태가 지정된 CEV를 선택합니다.
1. **작업**에 대해 **삭제**를 선택합니다.
***cev\$1name*을 삭제하시겠습니까?(Delete cev\$1name?)** 대화 상자가 표시됩니다.
1. **delete me**를 입력한 다음 **삭제**를 선택합니다.
**사용자 지정 엔진 버전(Custom engine versions)** 페이지의 배너에서 CEV가 삭제 중임을 표시합니다.
## AWS CLI
AWS CLI를 사용하여 CEV를 삭제하려면 [delete-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-custom-db-engine-version.html) 명령을 실행합니다.
다음 옵션이 필요합니다.
+ `--engine custom-sqlserver-ee`
+ `--engine-version cev`(*cev*는 삭제할 사용자 지정 엔진 버전의 이름)
다음 예제에서는 이름이 `15.00.4249.2.my_cevtest`인 CEV를 삭제합니다.
**Example**
대상 LinuxmacOS, 또는Unix:
```
1. aws rds delete-custom-db-engine-version \
2. --engine custom-sqlserver-ee \
3. --engine-version 15.00.4249.2.my_cevtest
```
Windows의 경우:
```
1. aws rds delete-custom-db-engine-version ^
2. --engine custom-sqlserver-ee ^
3. --engine-version 15.00.4249.2.my_cevtest
```