# 단일 테넌트 구성을 다중 테넌트로 변환
<a name="oracle-single-tenant-converting"></a>

RDS for Oracle CDB의 아키텍처를 단일 테넌트 구성에서 다중 테넌트 구성으로 수정할 수 있습니다. 변환 전과 후에는 CDB에 하나의 단일 테넌트 데이터베이스(PDB)가 포함됩니다. DB 인스턴스의 태그는 변환 중에 만들어진 초기 테넌트 데이터베이스에 전파됩니다.

시작하기 전에 IAM 정책에 테넌트 데이터베이스를 만들 수 있는 권한이 있는지 확인합니다. 변환 중에 RDS for Oracle은 다음 메타데이터를 새 테넌트 데이터베이스로 마이그레이션합니다.
+ 마스터 사용자 이름
+ 관리형 마스터 암호(소스 CDB가 Secrets Manager와 통합되는 경우)
+  데이터베이스 이름
+ 문자 집합
+ 내셔널 문자 집합

변환 전에 `describe-db-instances` 명령을 사용하여 위의 정보를 볼 수 있습니다. 변환 전에 `describe-tenant-database` 명령을 사용하여 정보를 볼 수 있습니다.

단일 테넌트에서 다중 테넌트로의 변환에는 다음과 같은 제한 사항이 있습니다.
+ 다중 테넌트 구성으로 변환한 후에는 단일 테넌트 구성으로 다시 변환할 수 없습니다. 변환은 되돌릴 수 없습니다.
+ Oracle Data Guard가 사용 설정된 기본 또는 복제본 데이터베이스는 변환할 수 없습니다.
+ 동일한 작업에서 DB 엔진 버전을 업그레이드하고 다중 테넌트 구성으로 변환할 수 없습니다.
+ 변환 중에는 관리형 마스터 사용자 암호를 활성화하거나 비활성화할 수 없습니다.

## 콘솔
<a name="oracle-cdb.configuring.converting.console"></a>

**단일 테넌트 구성을 사용하는 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 멀티테넌트 아키텍처**를 선택합니다.

1. **아키텍처 구성**에서 **다중 테넌트 구성**을 선택합니다.

1. (선택 사항) **DB 파라미터 그룹**에서 CDB 인스턴스의 새 파라미터 그룹을 선택합니다. DB 인스턴스를 변환할 때는 DB 인스턴스를 업그레이드할 때와 동일한 파라미터 그룹 고려 사항이 적용됩니다.

1. (선택 사항) **옵션 그룹**에서 CDB 인스턴스의 새로운 옵션 그룹을 선택합니다. DB 인스턴스를 변환할 때는 DB 인스턴스를 업그레이드할 때와 동일한 옵션 그룹 고려 사항이 적용됩니다.

1. 원하는 대로 모두 변경되었으면 [**Continue**]를 선택하고 수정 사항 요약을 확인합니다.

1. **즉시 적용**을 선택합니다. 이 옵션은 다중 테넌트 구성으로 전환할 때 필요합니다. 경우에 따라 이 옵션을 선택하면 가동 중지가 발생할 수 있습니다.

1. 확인 페이지에서 변경 내용을 검토합니다. 내용이 정확할 경우 **DB 인스턴스 수정**을 선택합니다.

   또는 **뒤로**를 선택하여 변경 내용을 편집하거나 **취소**를 선택하여 변경 내용을 취소합니다.

## AWS CLI
<a name="oracle-cdb.configuring.converting.cli"></a>

단일 테넌트 구성을 사용하는 CDB를 다중 테넌트 구성으로 변환하려면 [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) AWS CLI 명령에 `--multi-tenant`를 지정하세요.

다음 예시는 `my-st-cdb`라는 DB 인스턴스를 단일 테넌트 구성에서 다중 테넌트 구성으로 변환합니다. 옵션은 `--apply-immediately` 필수입니다.

**Example**  
대상 LinuxmacOS, 또는Unix:  

```
aws rds modify-db-instance --region us-east-1\
    --db-instance-identifier my-st-cdb \
    --multi-tenant \
    --apply-immediately
```
Windows의 경우:  

```
aws rds modify-db-instance --region us-east-1 ^
    --db-instance-identifier my-st-cdb ^
    --multi-tenant ^
    --apply-immediately
```
출력은 다음과 같습니다.  

```
{
    "DBInstance": {
        "DBInstanceIdentifier": "my-st-cdb",
        "DBInstanceClass": "db.r5.large",
        "MultiTenant": false,
        "Engine": "oracle-ee-cdb",
        "DBResourceId": "db-AB1CDE2FGHIJK34LMNOPRLXTXU",
        "DBInstanceStatus": "modifying",
        "MasterUsername": "admin",
        "DBName": "ORCL",
        ...
        "EngineVersion": "19.0.0.0.ru-2022-01.rur-2022-01.r1",
        "AutoMinorVersionUpgrade": true,
        "ReadReplicaDBInstanceIdentifiers": [],
        "LicenseModel": "bring-your-own-license",
        "OptionGroupMemberships": [
            {
                "OptionGroupName": "default:oracle-ee-cdb-19",
                "Status": "in-sync"
            }
        ],
        ...
        "PendingModifiedValues": {
            "MultiTenant": "true"
        }
    }
}
```