本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將單一租戶組態轉換為多租戶
<a name="oracle-single-tenant-converting"></a>

您可以將 RDS for Oracle CDB 的架構從單一租戶組態修改為多租戶組態。轉換前後，您的 CDB 會包含單一租戶資料庫 (PDB)。資料庫執行個體的標籤會傳播到轉換期間建立的初始租用戶資料庫。

開始之前，請確定您的 IAM 政策具有建立租用戶資料庫的許可。在轉換期間，RDS for Oracle 會將下列中繼資料遷移至新的租戶資料庫：
+ 主要使用者名稱
+ 受管主要密碼 (如果來源 CDB 與 Secrets Manager 整合)
+ 資料庫名稱
+ 字元集
+ 國家字元集

轉換前，您可以使用 `describe-db-instances` 命令檢視上述資訊。轉換後，您可以使用 `describe-tenant-database` 命令來檢視資訊。

從單一租用戶轉換至多租用戶的作業有下列限制：
+ 在轉換至多租用戶組態後，後續無法轉換回單一租用戶組態。轉換是不可復原的動作。
+ 您無法轉換已啟用 Oracle Data Guard 的主要或複本資料庫。
+ 您無法升級資料庫引擎版本，也無法在相同操作中轉換為多租戶組態。
+ 您無法在轉換期間啟用或停用受管主要使用者密碼。

## 主控台
<a name="oracle-cdb.configuring.converting.console"></a>

**將使用單一租戶組態的 CDB 轉換為多租戶組態**

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)：// 開啟 Amazon RDS 主控台。

1. 在 Amazon RDS 主控台的右上角，選擇資料庫執行個體所在的  AWS 區域 。

1. 在導覽窗格中，選擇**資料庫**，然後選擇您要轉換為多租戶組態的 CDB 執行個體。

1. 選擇 **Modify** (修改)。

1. 對於**架構設定**，選取 **Oracle 多租戶架構**。

1. 對於**架構組態**，選取**多租戶組態**。

1. (選用)對於**資料庫參數群組**，請為 CDB 執行個體選擇新的參數群組。在轉換資料庫執行個體時，也需要考慮與升級資料庫執行個體時相同的參數群組。

1. (選用) 在 **目標選項群組** 中，為 CDB 執行個體選擇新的選項群組。在轉換資料庫執行個體時，也需要考慮與升級資料庫執行個體時相同的選項群組。

1. 當所有變更都如您所願時，請選擇 **Continue (繼續)** 並查看修改摘要。

1. 選擇 **Apply immediately** (立即套用)。當您切換到多租戶組態時，需要此選項。請注意，此選項會在某些情況下導致停機。

1. 在確認頁面上，檢閱您的變更。如果都正確，請選擇**修改資料庫執行個體**。

   或者，選擇 **Back (上一步)** 以編輯變更，或是選擇 **Cancel (取消)** 以取消變更。

## 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` 的資料庫執行個體從單一租戶組態轉換為多租戶組態。`--apply-immediately` 選項為必要項目。

**Example**  
針對 Linux、macOS 或 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"
        }
    }
}
```