# 修改 RDS for Oracle 租户数据库
<a name="oracle-cdb-configuring.modifying.pdb"></a>

您只能修改 CDB 中租户数据库的 PDB 名称和主用户密码。请注意以下要求和限制：
+ 要修改数据库实例中租户数据库的设置，租户数据库必须存在。
+ 您无法在单个操作中修改多个租户数据库。一次只能修改一个租户数据库。
+ 您不能将租户数据库的名称更改为 `CDB$ROOT` 或 `PDB$SEED`。
+ 如果您的数据库实例有只读副本，则只能修改主数据库实例上的租户。还会验证复制运行状况，同时确保副本可用，并且在修改租户之前复制滞后小于 5 分钟。

您可以使用 AWS 管理控制台、AWS CLI 或 RDS API 修改 PDB。

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

**修改租户数据库的 PDB 名称或主密码**

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

1. 在 Amazon RDS 控制台的右上角，选择要在其中创建租户数据库的 AWS 区域。

1. 在导航窗格中，选择**数据库**。

1. 选择要修改其数据库名称或主用户密码的租户数据库。

1. 选择 **Modify**(修改)。

1. 对于**租户数据库设置**，请执行以下任意操作：
   + 对于**租户数据库名称**，输入新 PDB 的新名称。
   + 对于**租户数据库主密码**，输入新的密码。

1. 选择**修改租户**。

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

要使用 AWS CLI 修改租户数据库，请结合以下参数调用 [modify-tenant-database](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-tenant-database.html) 命令：
+ `--db-instance-identifier` *值*
+ `--tenant-db-name value`
+ `[--new-tenant-db-name value]`
+ `[--master-user-password value]`

以下示例在数据库实例 `my-cdb-inst` 上将租户数据库 `pdb1` 重命名为 `pdb-hr`。

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

```
1. aws rds modify-tenant-database --region us-east-1 \
2.     --db-instance-identifier my-cdb-inst \
3.     --tenant-db-name pdb1 \
4.     --new-tenant-db-name pdb-hr
```
对于：Windows  

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

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