# Converter a configuração de locatário único em multilocatário
<a name="oracle-single-tenant-converting"></a>

Você pode modificar a arquitetura de um CDB RDS para Oracle da configuração de locatário único para a configuração de multilocatário. Antes e depois da conversão, o CDB conterá um banco de dados de locatário único (PDB). As tags da instância de banco de dados se propagam para o banco de dados de locatário inicial criado durante a conversão.

Antes de começar, verifique se sua política do IAM tem permissão para criar um banco de dados de locatário. Durante a conversão, o RDS para Oracle migra os seguintes metadados para o novo banco de dados de locatários:
+ Nome do usuário principal
+ A senha principal gerenciada (se o CDB de origem se integrar ao Secrets Manager)
+ Nome do banco de dados
+ Conjunto de caracteres
+ Conjunto de caracteres nacionais

Antes da conversão, você visualiza as informações anteriores usando o comando `describe-db-instances`. Após da conversão, você pode visualizar as informações usando o comando `describe-tenant-database`.

A conversão de locatário único em multilocatário tem as seguintes limitações:
+ Portanto, não é possível voltar para a configuração de locatário único depois que você muda para a configuração multilocatário. A conversão é irreversível.
+ Não é possível converter um banco de dados primário ou de réplica que tenha o Oracle Data Guard habilitado.
+ Não é possível atualizar a versão do mecanismo de banco de dados e converter em uma configuração de multilocatário na mesma operação.
+ Durante a conversão, não é possível habilitar ou desabilitar senhas de usuário principal gerenciadas.

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

**Para converter um CDB usando a configuração de locatário único na configuração de vários locatários**

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, escolha a Região da AWS em que sua instância de banco de dados se encontra.

1. No painel de navegação, escolha **Bancos de dados** e selecione a instância de não CDB que deseja converter em instância de CDB. 

1. Escolha **Modificar**.

1. Em **Configurações de arquitetura**, selecione **Arquitetura multilocatário da Oracle**.

1. Em **Configuração de arquitetura**, selecione **Configuração multilocatária.**

1. (Opcional) Em **Grupo de parâmetros de banco de dados**, escolha um novo grupo de parâmetros para a instância de CDB. As mesmas considerações de grupos de parâmetros se aplicam tanto ao converter uma instância de banco de dados como ao fazer upgrade de uma instância de banco de dados.

1. (Opcional) Em **Grupo de opções**, escolha um novo grupo de opções para sua instância de CDB. As mesmas considerações de grupos de opções se aplicam tanto ao converter uma instância de banco de dados como ao fazer upgrade de uma instância de banco de dados.

1. Quando todas as alterações estiverem conforme o desejado, escolha **Continue (Continuar)** e verifique o resumo das modificações. 

1. Escolha **Apply immediately (Aplicar imediatamente)**. Essa opção é necessária quando você alterna para uma configuração de multilocatário. Essa opção pode causar inatividade em alguns casos.

1. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha **Modificar instância de banco de dados**.

   Ou escolha **Back (Voltar)** para editar as alterações ou **Cancel (Cancelar)** para cancelar as alterações.

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

Para converter um CDB usando a configuração de locatário único na configuração de multilocatário, especifique `--multi-tenant` no comando AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html).

O exemplo a seguir converte a instância de banco de dados chamada `my-st-cdb` da configuração de inquilino único para a configuração de multilocatário. A opção `--apply-immediately` é obrigatória.

**Example**  
Para Linux, macOS ou 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
```
A saída é semelhante ao apontado abaixo.  

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