# Convertir la configuración de un solo inquilino a una de varios inquilinos.
<a name="oracle-single-tenant-converting"></a>

Puede modificar la arquitectura de una CDB de RDS para Oracle (de configuración de un solo inquilino a varios inquilinos). Antes y después de la conversión, la CDB contiene una base de datos de un solo inquilino (PDB). Las etiquetas de la instancia de base de datos se propagan a la base de datos de inquilinos inicial creada durante la conversión.

Antes de comenzar, asegúrese de que la política de IAM tiene permiso para crear una base de datos de inquilinos. Durante la conversión, RDS para Oracle migra los siguientes metadatos a la nueva base de datos de inquilinos:
+ El nombre de usuario principal
+ La contraseña principal administrada (si CDB de origen se integra con Secrets Manager)
+ El nombre de la base de datos de 
+ El conjunto de caracteres
+ El conjunto de caracteres nacional

Antes de la conversión, vea la información anterior mediante el comando `describe-db-instances`. Después de la conversión, puede ver la información mediante el comando `describe-tenant-database`.

La conversión de un solo inquilino a varios inquilinos tiene las siguientes limitaciones:
+ No se puede volver a una configuración de un solo inquilino después de haber cambiado a configuración de varios inquilinos. La conversión es irreversible.
+ No puede convertir una base de datos principal o de réplica que tenga activado Oracle Data Guard.
+ No puede actualizar la versión del motor de base de datos y hacer la conversión a varios inquilinos en la misma operación.
+ No puede habilitar ni desactivar las contraseñas de usuario principal durante la conversión.

## Consola
<a name="oracle-cdb.configuring.converting.console"></a>

**Para convertir una CDB de un solo inquilino a una de varios inquilinos**

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 donde reside su instancia de base de datos.

1. En el panel de navegación, elija **Bases de datos** y, a continuación, seleccione la instancia no CDB que desee convertir en CDB. 

1. Elija **Modificar**.

1. En **Configuración de la arquitectura**, elija **Arquitectura multitenencia de Oracle**.

1. En **Configuración de la arquitectura**, seleccione **Configuración multitenencia**.

1. (Opcional) En **Grupo de parámetros de base de datos**, elija un nuevo grupo de parámetros para la instancia de CDB. Se aplican las mismas consideraciones de grupo de parámetros al convertir una instancia de base de datos que al actualizar una instancia de base de datos.

1. (Opcional) En **Grupo de opciones**, elija un nuevo grupo de opciones para la instancia CDB. Se aplican las mismas consideraciones de grupo de parámetros de opciones al convertir una instancia de base de datos que al actualizar una instancia de base de datos.

1. Cuando haya realizado todos los cambios que desee, elija **Continue** y compruebe el resumen de las modificaciones. 

1. Seleccione **Apply immediately (Aplicar inmediatamente)**. Esta opción es necesaria cuando se cambia a una configuración de varios inquilinos. Tenga en cuenta que esta opción puede generar tiempo de inactividad en algunos casos.

1. En la página de confirmación, revise los cambios. Si son correctos, elija **Modificar la instancia de base de datos**.

   O bien, elija **Back** (Atrás) para editar los cambios o **Cancel** (Cancelar) para cancelarlos.

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

Para convertir una CDB de un solo inquilino a una de varios inquilinos, especifique `--multi-tenant` en el comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) de la AWS CLI.

El siguiente ejemplo convierte la instancia de base de datos denominada `my-st-cdb` de la configuración de un solo inquilino a la de varios inquilinos. La opción `--apply-immediately` es obligatoria.

**Example**  
Para Linux, macOS o Unix:  

```
aws rds modify-db-instance --region {{us-east-1}}\
    --db-instance-identifier {{my-st-cdb}} \
    --multi-tenant \
    --apply-immediately
```
Para Windows:  

```
aws rds modify-db-instance --region {{us-east-1}} ^
    --db-instance-identifier {{my-st-cdb}} ^
    --multi-tenant ^
    --apply-immediately
```
El resultado es similar al siguiente.  

```
{
    "DBInstance": {
        "DBInstanceIdentifier": "my-st-cdb",
        "DBInstanceClass": "db.r5.large",
        "MultiTenant": false,
        "Engine": "oracle-ee-cdb",
        "DBResourceId": "db-AB1CDE2FGHIJK34LMNOPRLXTXU",
        "DBInstanceStatus": "modifying",
        "MasterUsername": "admin",
        "DBName": "ORCL",
        ...
        "EngineVersion": "19.0.0.0.ru-2022-01.rur-2022-01.r1",
        "AutoMinorVersionUpgrade": true,
        "ReadReplicaDBInstanceIdentifiers": [],
        "LicenseModel": "bring-your-own-license",
        "OptionGroupMemberships": [
            {
                "OptionGroupName": "default:oracle-ee-cdb-19",
                "Status": "in-sync"
            }
        ],
        ...
        "PendingModifiedValues": {
            "MultiTenant": "true"
        }
    }
}
```