# 从您的 CDB 中删除 RDS for Oracle 租户数据库
<a name="oracle-cdb-configuring.deleting.pdb"></a>

您可以使用 AWS 管理控制台、AWS CLI 或 RDS API 删除租户数据库（PDB）。请考虑以下先决条件和限制：
+ 租户数据库和数据库实例必须存在。
+ 要成功删除，必须存在以下情况之一：
  + 租户数据库和数据库实例可用。
**注意**  
您可以拍摄最终快照，但前提是租户数据库和数据库实例在发出 `delete-tenant-database` 命令之前处于可用状态。仅当数据库实例有只读副本时，才会在主实例上拍摄此快照。
  + 正在创建租户数据库。
  + 数据库实例正在修改租户数据库。
  + 如果数据库实例有只读副本，则这些限制适用于所有副本。
+ 您无法在单个操作中删除多个租户数据库。
+ 如果租户数据库是 CDB 中唯一的租户，则无法将其删除。
+ 您无法删除只读副本上的租户数据库，只能删除主数据库实例上的租户。还会验证复制运行状况，同时确保在删除租户之前，复制滞后小于 5 分钟。

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

**删除租户数据库**

1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台：[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)。

1. 在导航窗格中，选择**数据库**，然后选择要删除的租户数据库。

1. 对于 ** Actions**，选择 **Delete**。

1. 要为数据库实例创建最终数据库快照，请选择**是否创建最终快照?**。

1. 如果选择创建最终快照，请输入**最终快照名称**。

1. 在框中输入 **delete me**。

1. 选择 **Delete**。

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

要使用 AWS CLI 删除租户数据库，请结合以下参数调用 [delete-tenant-database](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-tenant-database.html) 命令：
+ `--db-instance-identifier value`
+ `--tenant-db-name value`
+ `[--skip-final-snapshot | --no-skip-final-snapshot]`
+ `[--final-snapshot-identifier value]`

以下示例从名为 *my-cdb-inst* 的 CDB 中删除名为 *pdb-test* 的租户数据库。默认情况下，该操作会创建最终快照。

**Example**  
对于 Linux、macOS 或 Unix：  

```
1. aws rds delete-tenant-database --region us-east-1 \
2.     --db-instance-identifier my-cdb-inst \
3.     --tenant-db-name pdb-test \
4.     --final-snapshot-identifier final-snap-pdb-test
```
对于：Windows  

```
1. aws rds delete-tenant-database --region us-east-1 ^
2.     --db-instance-identifier my-cdb-inst ^
3.     --tenant-db-name pdb-test ^
4.     --final-snapshot-identifier final-snap-pdb-test
```
此命令生成类似于下述信息的输出。  

```
{
    "TenantDatabase" : {
        "DbiResourceId" : "db-abc123",
        "TenantDatabaseResourceId" : "tdb-bac456",
        "TenantDatabaseArn" : "arn:aws:rds:us-east-1:123456789012:db:my-cdb-inst:pdb-test",
        "DBInstanceIdentifier" : "my-cdb-inst",
        "TenantDBName" : "pdb-test",
        "Status" : "deleting",
        "MasterUsername" : "pdb-test-admin"
        "Port" : "6555",
        "CharacterSetName" : "UTF-16",
        "MaxAllocatedStorage" : "1000",
        "ParameterGroups": [
            {
                "ParameterGroupName": "tenant-1-params",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "OptionGroupMemberships": [
            {
                "OptionGroupName": "tenant-1-options",
                "Status": "in-sync"
            }
        ]
    }
}
```