# RDS for Oracle テナントデータベースの変更
<a name="oracle-cdb-configuring.modifying.pdb"></a>

CDB 内のテナントデータベースは、PDB 名とマスターユーザーパスワードのみを変更できます。次の要件と制限事項に注意してください。
+ DB インスタンス内のテナントデータベースの設定を変更するには、テナントデータベースが存在していなければなりません。
+ 1 回の操作で、複数のテナントデータベースを変更することはできません。一度に変更できるテナントデータベースは 1 つのみです。
+ テナントデータベースの名前を `CDB$ROOT` または `PDB$SEED` に変更することはできません。
+ DB インスタンスにリードレプリカがある場合は、プライマリ DB インスタンスのテナントのみ変更できます。レプリケーションの正常性も検証され、テナントが変更される前にレプリカが利用可能で、レプリケーションの遅延が 5 分未満であることが確認されます。

PDBは、AWS マネジメントコンソール、AWS CLI、または RDS API を使用して変更できます。

## コンソール
<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. ナビゲーションペインで、**[Databases]** (データベース) を選択します。

1. データベース名またはマスターユーザーパスワードを変更したいテナントデータベースを選択します。

1. **[Modify]** (変更) を選択します。

1. **[テナントデータベース設定]** では、以下のいずれかの操作を行います。
   + **[テナントデータベース名]** には、新しいデータベースの新しい名前を入力します。
   + **[テナントデータベースのマスターパスワード]** に、新しいパスワードを入力します。

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]`

次の例では、テナントデータベースの名前を DB インスタンス `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"
        }
    }
}
```