

# Modificando um banco de dados de locatários do RDS para Oracle
<a name="oracle-cdb-configuring.modifying.pdb"></a>

Você pode modificar somente o nome do PDB e a senha do usuário mestre de um banco de dados de inquilinos no seu CDB. Anote os seguintes requisitos e limitações para o :
+ Para modificar as configurações de um banco de dados de inquilinos em sua instância de banco de dados, o banco de dados de inquilinos deve existir. 
+ Você não pode modificar vários bancos de dados de inquilinos em uma única operação. É possível modificar apenas um banco de dados de inquilinos de cada vez.
+ Você não pode alterar o nome de um banco de dados de inquilinos para `CDB$ROOT` ou`PDB$SEED`.
+ Se a instância de banco de dados tiver réplicas de leitura, só será possível modificar os locatários na instância de banco de dados primário. A integridade da replicação também é validada, garantindo que as réplicas estejam disponíveis e que o atraso na replicação seja inferior a 5 minutos antes da modificação do locatário.

Você pode modificar um cluster de banco de dados usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.

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

**Para modificar o nome do PDB ou a senha mestra de um banco de dados de inquilinos**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No canto superior direito do console do Amazon RDS, selecione a Região da AWS na qual você deseja criar o cluster de banco de dados.

1. No painel de navegação, escolha **Bancos de dados**.

1. Escolha o banco de dados do inquilino cujo nome do banco de dados ou senha do usuário mestre você deseja modificar.

1. Escolha **Modificar**.

1. Para **Global database settings (Configurações de banco de dados globais)**, faça o seguinte:
   + Em **Nome do banco de dados inicial**, insira o nome do PDB.
   + Para **Senha mestra do banco de dados do locatário**, insira uma nova senha.

1. Escolha **Modificar inquilino.**

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

Para modificar um banco de dados de inquilinos usando oAWS CLI, chame o comando [modify-tenant-database](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-tenant-database.html) com os seguintes parâmetros:
+ `--db-instance-identifier` *Valor do*
+ `--tenant-db-name value`
+ `[--new-tenant-db-name value]`
+ `[--master-user-password value]`

O exemplo a seguir renomeia o banco de dados do inquilino `pdb1` para uma instância de banco `pdb-hr` de dados. `my-cdb-inst`

**Example**  
Para Linux, macOS ou 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
```
Para 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
```
O comando gerará uma saída semelhante à seguinte:   

```
{
    "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"
        }
    }
}
```