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

# 將 RDS for Oracle 租戶資料庫新增至 CDB 執行個體
<a name="oracle-cdb-configuring.adding.pdb"></a>

在 RDS for Oracle 多租戶組態中，租戶資料庫是 PDB。若要新增租戶資料庫，請確定符合下列先決條件：
+ 您的 CDB 已啟用多租戶組態。如需詳細資訊，請參閱[CDB 架構的多租戶組態](Oracle.Concepts.CDBs.md#multi-tenant-configuration)。
+ 您擁有建立租戶資料庫的必要 IAM 許可。

您可以使用 AWS 管理主控台 AWS CLI、 或 RDS API 新增租戶資料庫。您無法在單一操作中新增多個租戶資料庫：您必須一次新增一個租戶資料庫。如果 CDB 已啟用備份保留，則 Amazon RDS 會在新增租戶資料庫之前和之後備份資料庫執行個體。如果 CDB 具有僅供讀取複本，您只能將租戶資料庫新增至主要資料庫執行個體；Amazon RDS 會自動在複本上建立租戶資料庫。複寫運作狀態也會經過驗證，確保所有複本都可用，而且複寫延遲在建立租用戶前不到 5 分鐘。

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

**將租戶資料庫新增至您的資料庫執行個體**

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

1. 在 Amazon RDS 主控台的右上角，選擇要在其中建立租戶資料庫的 AWS 區域 。

1. 在導覽窗格中，選擇 **Databases** (資料庫)。

1. 選擇您要將租戶資料庫新增至其中的 CDB 執行個體。您的資料庫執行個體必須使用 CDB 架構的多租戶組態。

1. 選擇**動作**，然後選擇**新增租戶資料庫**。

1. 對於**租戶資料庫設定**，請執行下列動作：
   + 對於**租戶資料庫名稱**，輸入新 PDB 的名稱。
   + 對於**租戶資料庫主要使用者名稱**，為 PDB 輸入主要使用者的名稱。
   + 選擇下列其中一個憑證管理選項：
     + **在 中受管 AWS Secrets Manager**

       在**選取加密金鑰中**，選擇 Secrets Manager 建立的 KMS 金鑰或您建立的金鑰。
**注意**  
我們建議將 AWS Secrets Manager 作為管理憑證的最安全技術。需支付額外費用。使用僅供讀取複本的執行個體 AWS Secrets Manager 不支援 。如需詳細資訊，請參閱[使用 Amazon RDS 和 進行密碼管理 AWS Secrets Manager](rds-secrets-manager.md)。
     + **自我管理**

       若要指定密碼，請清除**自動產生密碼**核取方塊 (如果已選取)。在**主要密碼**和**確認密碼**中輸入相同的密碼。
     + 在**其他組態**底下，輸入您的 PDB 名稱做為**初始資料庫名稱**。您無法命名具有預設名稱 `RDSCDB` 的 CDB。
   + 對於**租用戶資料庫字元集**，選擇 PDB 的字元集。預設值為 **AL32UTF8**。您可以選擇不同於 CDB 字元集的 PDB 字元集。如果執行個體具有僅供讀取複本，則無法使用自訂字元集建立租用戶。如有需要，您可以在建立僅供讀取複本之前，使用自訂字元集建立租用戶。
   + 對於**租戶資料庫國家字元集**，選擇 PDB 的國家字元集。預設值為 **AL32UTF8**。國家字元集只會針對使用 `NCHAR` 資料類型 (`NCHAR`、`NVARCHAR2` 和 `NCLOB`) 的資料行指定編碼，而且不會影響資料庫中繼資料。

   如需上述設定的詳細資訊，請參閱 [資料庫執行個體的設定](USER_CreateDBInstance.Settings.md)。

1. 選擇**新增租戶**。

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

若要使用 將租戶資料庫新增至 CDB AWS CLI，請使用 命令 [create-tenant-database](https://docs.aws.amazon.com/cli/latest/reference/rds/create-tenant-database.html) 搭配下列必要參數：
+ `--db-instance-identifier`
+ `--tenant-db-name`
+ `--master-username`
+ `--master-user-password`

下列範例會在名為 *my-cdb-inst* 的 RDS for Oracle RDS 執行個體中建立名為 *mypdb2* 的租戶資料庫。PDB 字元集為 `UTF-16`。

**Example**  
針對 Linux、macOS 或 Unix：  

```
1. aws rds create-tenant-database --region us-east-1 \
2.     --db-instance-identifier my-cdb-inst \
3.     --tenant-db-name mypdb2 \
4.     --master-username mypdb2-admin \
5.     --master-user-password mypdb2-pwd \
6.     --character-set-name UTF-16
```
在 Windows 中：  

```
1. aws rds create-tenant-database --region us-east-1 \
2.     --db-instance-identifier my-cdb-inst ^
3.     --tenant-db-name mypdb2 ^
4.     --master-username mypdb2-admin ^
5.     --master-user-password mypdb2-pwd ^
6.     --character-set-name UTF-16
```
輸出結果類似如下。  

```
...}
    "TenantDatabase" :
         {
            "DbiResourceId" : "db-abc123",
            "TenantDatabaseResourceId" : "tdb-bac567",
            "TenantDatabaseArn" : "arn:aws:rds:us-east-1:123456789012:db:my-cdb-inst:mypdb2",
            "DBInstanceIdentifier" : "my-cdb-inst",
            "TenantDBName" : "mypdb2",
            "Status" : "creating",
            "MasterUsername" : "mypdb2",
            "CharacterSetName" : "UTF-16",
            ...
        }
}...
```