# Añadir una base de datos de inquilinos de RDS para Oracle a su instancia de CDB
En la configuración de varios inquilinos de RDS para Oracle, una base de datos de inquilinos es una PDB. Para agregar una base de datos de inquilinos, asegúrese de que cumple los siguientes requisitos previos:
+ Su CDB tiene habilitada la configuración de varios inquilinos. Para obtener más información, consulte [Configuración de varios inquilinos de la arquitectura CDB](Oracle.Concepts.CDBs.md#multi-tenant-configuration).
+ Tiene los permisos de IAM necesarios para crear la base de datos de inquilinos.
Puede añadir una base de datos de inquilinos mediante la Consola de administración de AWS, la AWS CLI o la API de RDS. No puede agregar varias bases de datos de inquilinos en una sola operación: debe agregarlas de una en una. Si la CDB tiene habilitada la retención de copias de seguridad, Amazon RDS realiza una copia de seguridad de la instancia de base de datos antes y después de añadir una nueva base de datos de inquilinos. Si la CDB tiene réplicas de lectura, solo puede añadir una base de datos de inquilinos a la instancia de DB principal; Amazon RDS crea automáticamente la base de datos de inquilinos en las réplicas. El estado de la replicación también se valida, lo que garantiza que todas las réplicas estén disponibles y que el retraso de la replicación sea inferior a 5 minutos antes de que se cree el inquilino.
## Consola
**Para añadir una base de datos de inquilinos a su instancia de base de datos**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. En la esquina superior derecha de la consola de Amazon RDS, elija la Región de AWS en la que desea crear la base de datos de inquilinos.
1. En el panel de navegación, elija **Databases** (Bases de datos).
1. Elija la instancia de CDB a la que desea agregar una base de datos de inquilinos. La instancia de base de datos debe usar la configuración de varios inquilinos de la arquitectura CDB.
1. Elija **Acciones** y, a continuación, **Agregar base de datos de inquilinos**.
1. En **Configuración de la base de datos de inquilinos**, haga lo siguiente:
+ En **Nombre de la base de datos de inquilinos**, escriba el nombre de la nueva PDB.
+ En **Nombre de usuario principal de la base de datos de inquilinos**, escriba el nombre del usuario principal de la PDB.
+ Elija cualquiera de las siguientes opciones de administración de credenciales:
+ **Administrado en AWS Secrets Manager**
En **Seleccionar la clave de cifrado**, elija una clave de KMS que cree Secrets Manager o una clave que haya creado usted.
**nota**
Recomendamos AWS Secrets Manager como la técnica más segura para administrar las credenciales. Se aplican cargos adicionales. AWS Secrets Manager no se admite en las instancias que utilizan réplicas de lectura. Para obtener más información, consulte [Administración de contraseñas con Amazon RDS y AWS Secrets Manager](rds-secrets-manager.md).
+ **Autoadministrado**
Para especificar una contraseña, desactive la casilla de verificación **Generar una contraseña de forma automática** si está seleccionada. Ingrese la misma contraseña en **Contraseña principal** y elija **Confirmar contraseña principal**.
+ En **Configuración adicional**, ingrese el nombre de la PDB para **Nombre de base de datos inicial**. No puede asignar un nombre a la CDB que tenga el nombre predeterminado `RDSCDB`.
+ En **Conjunto de caracteres de base de datos de inquilinos**, seleccione un conjunto de caracteres para la PDB. El valor predeterminado es **AL32UTF8**. Puede elegir un conjunto de caracteres de PDB distinto del de la CDB. Si la instancia tiene réplicas de lectura, no se pueden crear inquilinos con un juego de caracteres personalizado. Si es necesario, puede crear sus inquilinos con un juego de caracteres personalizado antes de crear una réplica de lectura.
+ En **Conjunto de caracteres nacional de la base de datos de inquilinos**, seleccione un conjunto de caracteres para la PDB. El valor predeterminado es **AL32UTF8**. El conjunto de caracteres nacional especifica la codificación solo para las columnas que utilizan el tipo de datos `NCHAR` (`NCHAR`, `NVARCHAR2` y `NCLOB`), y no afecta a los metadatos de la base de datos.
Para obtener más información sobre estos ajustes, consulte [Configuración de instancias de base de datos](USER_CreateDBInstance.Settings.md).
1. Seleccione **Agregar inquilino**.
## AWS CLI
Para añadir una base de datos de inquilinos a su CDB con la AWS CLI, use el comando [create-tenant-database](https://docs.aws.amazon.com/cli/latest/reference/rds/create-tenant-database.html) con los siguientes parámetros obligatorios:
+ `--db-instance-identifier`
+ `--tenant-db-name`
+ `--master-username`
+ `--master-user-password`
En el siguiente ejemplo, se crea una base de datos de inquilinos denominada *mypdb2* en la instancia de CDB de RDS para Oracle denominada *my-cdb-inst*. El conjunto de caracteres de la PDB es `UTF-16`.
**Example**
Para Linux, macOS o 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
```
El resultado tiene un aspecto similar al siguiente.
```
...}
"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",
...
}
}...
```