# RDS for Oracle 비CDB를 CDB로 변환
`modify-db-instance` 명령을 통해 Oracle 데이터베이스의 아키텍처를 비CDB 아키텍처에서 Oracle 멀티테넌트 아키텍처(CDB 아키텍처)로 변경할 수 있습니다.** 대부분의 경우 새 CDB를 만들고 데이터를 가져오는 것보다 이 방법을 사용하는 것이 좋습니다. 변환 작업 시 다운타임이 발생합니다.
데이터베이스 엔진 버전을 업그레이드할 때 동일한 작업에서 데이터베이스 아키텍처를 변경할 수 없습니다. 따라서 Oracle Database 19c 비CDB를 Oracle Database 21c CDB로 업그레이드하려면 먼저 한 단계에서 비CDB를 CDB로 변환한 다음, 별도의 단계에서 19c CDB를 21c CDB로 업그레이드해야 합니다.
비CDB 변환 작업에는 다음과 같은 요구 사항이 있습니다.
+ DB 엔진 유형에는 `oracle-ee-cdb` 또는 `oracle-se2-cdb`를 지정해야 합니다. 이 값만 지원됩니다.
+ DB 엔진은 2021년 4월 이후 릴리스 업데이트(RU)가 포하된 Oracle Database 19c를 사용해야 합니다.
이 작업에는 다음과 같은 제한 사항이 있습니다.
+ CDB를 비CDB로 변환할 수 없습니다. 비CDB를 CDB로만 변환할 수 있습니다.
+ 하나의 `modify-db-instance` 호출로 비CDB를 다중 테넌트 구성으로 변환할 수 없습니다. 비CDB를 CDB로 변환한 후에 CDB는 단일 테넌트 구성이 됩니다. 단일 테넌트 구성을 다중 테넌트 구성으로 변환하려면 `modify-db-instance`를 다시 실행하세요. 자세한 내용은 [단일 테넌트 구성을 다중 테넌트로 변환](oracle-single-tenant-converting.md) 섹션을 참조하세요.
+ Oracle Data Guard가 사용 설정된 기본 또는 복제본 데이터베이스는 변환할 수 없습니다. 읽기 전용 복제본이 있는 비CDB를 변환하려면 먼저 읽기 전용 복제본을 모두 삭제하세요.
+ 동일한 작업에서 DB 엔진 버전을 업그레이드하고 비CDB를 CDB로 변환할 수 없습니다.
비CDB를 전환하기 전에 다음 사항을 고려하세요.
+ 옵션 및 파라미터 그룹에 대한 고려 사항은 DB 엔진 업그레이드와 동일합니다. 자세한 내용은 [Oracle 데이터베이스 업그레이드에 대한 고려 사항](USER_UpgradeDBInstance.Oracle.OGPG.md) 섹션을 참조하세요.
+ 관리형 마스터 암호를 사용하는 기존 비CDB 인스턴스를 단일 작업을 사용하여 단일 테넌트 인스턴스로 변환할 수 있습니다. 단일 테넌트 인스턴스는 관리형 암호를 상속합니다.
+ DB 인스턴스에 `OEMAGENT` 옵션이 설치되어 있는 경우 비CDB로 전환하기 전에 이 옵션을 제거하는 것이 가장 좋습니다. 비CDB를 CDB로 전환한 후 옵션을 다시 설치하세요. 자세한 내용은 [Oracle Management Agent for Enterprise Manager Cloud Control](Oracle.Options.OEMAgent.md) 섹션을 참조하세요.
+ 변환 프로세스 중에 RDS는 온라인 다시 실행 로그 크기를 기본값 128M으로 재설정합니다.
## 콘솔
**비CDB를 CDB로 변환하는 방법**
1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon RDS 콘솔을 엽니다.
1. Amazon RDS 콘솔의 오른쪽 상단에서 DB 인스턴스가 상주하는 AWS 리전을 선택합니다.
1. 탐색 창에서 **데이터베이스**를 선택한 후 CDB 인스턴스로 변환하려는 비CDB 인스턴스를 선택합니다.
1. **수정**을 선택합니다.
1. **아키텍처 설정**에서 **Oracle 멀티테넌트 아키텍처**를 선택합니다. 변환 후 CDB는 단일 테넌트 구성이 됩니다.
1. (선택 사항) **DB 파라미터 그룹**에서 CDB 인스턴스의 새 파라미터 그룹을 선택합니다. DB 인스턴스를 변환할 때는 DB 인스턴스를 업그레이드할 때와 동일한 파라미터 그룹 고려 사항이 적용됩니다. 자세한 내용은 [파라미터 그룹 고려 사항](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.PG) 섹션을 참조하세요.
1. (선택 사항) **옵션 그룹**에서 CDB 인스턴스의 새로운 옵션 그룹을 선택합니다. DB 인스턴스를 변환할 때는 DB 인스턴스를 업그레이드할 때와 동일한 옵션 그룹 고려 사항이 적용됩니다. 자세한 내용은 [옵션 그룹 고려 사항](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG) 섹션을 참조하세요.
1. (선택 사항) **자격 증명 관리**에서 **AWS Secrets Manager에서 관리** 또는 **자체 관리**를 선택합니다. 자세한 내용은 [Secrets Manager를 통해 DB 인스턴스의 마스터 사용자 암호 관리](rds-secrets-manager.md#rds-secrets-manager-db-instance) 섹션을 참조하세요.
1. 원하는 대로 모두 변경되었으면 [**Continue**]를 선택하고 수정 사항 요약을 확인합니다.
1. (선택 사항) **즉시 적용**을 선택하여 변경 내용을 즉시 적용합니다. 일부의 경우 이 옵션을 선택하면 가동 중지 시간이 발생할 수 있습니다. 자세한 내용은 [수정 예약 설정 사용](USER_ModifyInstance.ApplyImmediately.md) 섹션을 참조하세요.
1. 확인 페이지에서 변경 내용을 검토합니다. 내용이 정확할 경우 **DB 인스턴스 수정**을 선택합니다.
또는 **뒤로**를 선택하여 변경 내용을 편집하거나 **취소**를 선택하여 변경 내용을 취소합니다.
## AWS CLI
DB 인스턴스의 비CDB를 단일 테넌트 구성의 CDB로 변환하려면 [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) AWS CLI 명령에서 `--engine`을 `oracle-ee-cdb` 또는 `oracle-se2-cdb`로 설정합니다. 자세한 내용은 [DB 인스턴스에 대한 설정](USER_ModifyInstance.Settings.md) 섹션을 참조하세요.
다음 예에서는 *my-non-cdb*라는 이름의 DB 인스턴스를 변환하고 사용자 지정 옵션 그룹과 파라미터 그룹을 지정합니다. 명령은 Secrets Manager를 사용한 암호 관리도 활성화합니다.
**Example**
대상 LinuxmacOS, 또는Unix:
```
aws rds modify-db-instance \
--db-instance-identifier my-non-cdb \
--engine oracle-ee-cdb \
--option-group-name custom-option-group \
--db-parameter-group-name custom-parameter-group \
--manage-master-user-password
```
Windows의 경우:
```
aws rds modify-db-instance ^
--db-instance-identifier my-non-cdb ^
--engine oracle-ee-cdb ^
--option-group-name custom-option-group ^
--db-parameter-group-name custom-parameter-group ^
--manage-master-user-password
```
## RDS API
비CDB를 CDB로 변환하려면 [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) RDS API 작업에서 `Engine`을 지정합니다.