# Adicionar um banco de dados de locatários do RDS for Oracle à sua instância de CDB
Na configuração multilocatária do RDS for Oracle, um banco de dados de inquilinos é um PDB. Para adicionar um banco de dados de inquilinos, certifique-se de que os seguintes pré-requisitos sejam atendidos:
+ Seu CDB tem a configuração multilocatária ativada. Para obter mais informações, consulte [Configuração de multilocatário da arquitetura CDB](Oracle.Concepts.CDBs.md#multi-tenant-configuration).
+ Você tem as permissões necessárias do IAM para criar o banco de dados do inquilino.
Você pode adicionar um banco de dados de inquilinos usando a Console de gerenciamento da AWSAWS CLI, a ou a API do RDS. Você não pode adicionar vários bancos de dados de inquilinos em uma única operação: você deve adicioná-los um por vez. Se o CDB tiver a retenção de backup ativada, o Amazon RDS fará backup da instância de banco de dados antes e depois de adicionar um novo banco de dados de inquilinos. Se o CDB tiver réplicas de leitura, só será possível adicionar um banco de dados de locatários à instância de banco de dados primário. O Amazon RDS cria automaticamente o banco de dados de locatários nas réplicas. A integridade da replicação também é validada, garantindo que todas as réplicas estejam disponíveis e que o atraso na replicação seja inferior a 5 minutos antes da criação do locatário.
## Console
**Para adicionar um banco de dados de inquilinos à sua instância de banco de dados**
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 a instância do CDB à qual você deseja adicionar um banco de dados de locatários. Sua instância de banco de dados deve usar a configuração multilocatária da arquitetura CDB.
1. Escolha **Ações** e, em seguida, **Adicionar banco de dados de inquilinos**.
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 o nome de **usuário mestre do banco** de dados do locatário, insira o nome do usuário mestre do seu PDB.
+ Escolha uma das seguintes opções de gerenciamento de credenciais:
+ **Gerenciado no AWS Secrets Manager**
Em **Selecionar a chave de criptografia**, escolha uma chave do KMS que o Secrets Manager cria ou uma chave que você criou.
**nota**
Recomendamos o AWS Secrets Manager como a técnica mais segura para gerenciar credenciais. Cobranças adicionais se aplicam. O AWS Secrets Manager não é compatível com instâncias que usam réplicas de leitura. Para obter mais informações, consulte [Gerenciamento de senhas com Amazon RDS e AWS Secrets Manager](rds-secrets-manager.md).
+ **Autogerenciado**
Para especificar uma senha, desmarque a caixa de seleção **Gerar uma senha automaticamente** se ela estiver marcada. Insira a mesma senha em **Senha primária** e **Confirmar senha**.
+ Em **Configuração adicional**, insira o nome do seu PDB em **Nome do banco de dados inicial**. Você não pode nomear o CDB, que tem o nome padrão `RDSCDB`.
+ Para o **conjunto de caracteres do banco de dados do locatário**, escolha um conjunto de caracteres para o PDB. O padrão é **AL32UTF8**. Você pode escolher um conjunto de caracteres PDB diferente do conjunto de caracteres CDB. Se a instância tiver réplicas de leitura, não será possível criar locatários com um conjunto de caracteres personalizado. É possível criar locatários com um conjunto de caracteres personalizado antes de criar uma réplica de leitura, se necessário.
+ Para o **conjunto de caracteres nacionais do banco de dados do inquilino**, escolha um conjunto de caracteres nacional para o PDB. O padrão é **AL32UTF8**. O conjunto de caracteres nacionais especifica a codificação somente para colunas que usam o tipo de `NCHAR` dados (`NCHAR`,`NVARCHAR2`, e`NCLOB`) e não afeta os metadados do banco de dados.
Para obter mais informações sobre os arquivos de configurações, consulte [Configurações para instâncias de banco de dados](USER_CreateDBInstance.Settings.md).
1. Escolha **Adicionar inquilino.**
## AWS CLI
Para adicionar um banco de dados de inquilinos ao seu CDB com oAWS CLI, use o comando [create-tenant-database](https://docs.aws.amazon.com/cli/latest/reference/rds/create-tenant-database.html) com os seguintes parâmetros necessários:
+ `--db-instance-identifier`
+ `--tenant-db-name`
+ `--master-username`
+ `--master-user-password`
*O exemplo a seguir cria um banco de dados de inquilinos chamado *mypdb2* na instância RDS para Oracle CDB chamada my-cdb-inst.* O conjunto de caracteres do PDB é`UTF-16`.
**Example**
Para Linux, macOS ou 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
```
Para 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
```
A saída será semelhante à seguinte.
```
...}
"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",
...
}
}...
```