

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Conversione della configurazione a tenant singolo in multi-tenant
<a name="oracle-single-tenant-converting"></a>

È possibile modificare l'architettura di un CDB RDS per Oracle dalla configurazione a tenant singolo alla configurazione multi-tenant. Prima e dopo la conversione, il CDB contiene un database a tenant singolo (PDB). I tag per l’istanza database si propagano al database del tenant iniziale creato durante la conversione.

Prima di iniziare, è necessario assicurarsi che la policy IAM disponga delle autorizzazioni necessarie per creare un database del tenant. Durante la conversione, RDS per Oracle migra i seguenti metadati nel nuovo database del tenant:
+ Il nome utente principale
+ La password master gestita (se il CDB di origine si integra con Secrets Manager)
+ Il nome del database 
+ Il set di caratteri
+ Il set di caratteri nazionali

Prima della conversione, è possibile visualizzare le informazioni precedenti utilizzando il comando `describe-db-instances`. Dopo la conversione, è possibile visualizzare le informazioni utilizzando il comando `describe-tenant-database`.

La conversione da tenant singolo a multi-tenant presenta le seguenti limitazioni:
+ Non è possibile riconvertire la configurazione multi-tenant in configurazione a tenant singolo dopo una conversione in configurazione multi-tenant. La conversione è irreversibile.
+ Non è possibile convertire un database primario o di replica con Oracle Data Guard abilitato.
+ Non è possibile aggiornare la versione del motore di database e convertire nella configurazione multi-tenant durante la stessa operazione.
+ Non è possibile abilitare o disabilitare le password di utente master gestite durante la conversione.

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

**Per convertire un CDB con la configurazione a tenant singolo in quella multi-tenant**

1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Nell'angolo in alto a destra della console Amazon RDS, scegliere la Regione AWS  in cui si trova l'istanza database.

1. Nel riquadro di navigazione, scegliere **Database** e quindi l'istanza non CDB da convertire in istanza CDB. 

1. Scegli **Modifica**.

1. In **Impostazioni dell'architettura**, seleziona **Architettura multitenant Oracle**.

1. Per **Configurazione dell'architettura** seleziona **Configurazione multi-tenant**.

1. (Facoltativo) In **Gruppo di parametri database**, scegliere un nuovo gruppo di parametri per l'istanza CDB. Le stesse considerazioni relative ai gruppi di parametri valgono per la conversione di un'istanza database e per l'aggiornamento di un'istanza database.

1. (Facoltativo) In **Gruppo di opzioni**, selezionare un nuovo gruppo di opzioni per l'istanza CDB. Le stesse considerazioni relative ai gruppi di opzioni valgono per la conversione di un'istanza database e per l'aggiornamento di un'istanza database.

1. Quando tutte le modifiche sono come le desideri, seleziona **Continue (Continua)** e controlla il riepilogo delle modifiche. 

1. Scegliere **Apply immediately** (Applica immediatamente). Questa opzione è necessaria quando si passa a una configurazione multi-tenant. Tieni presente che questa opzione può causare tempi di inattività in alcuni casi.

1. Nella pagina di conferma esaminare le modifiche. Se sono corrette, selezionare **Modifica istanza database**.

   Oppure scegliere **Back (Indietro)** per cambiare le modifiche o **Cancel (Annulla)** per annullare le modifiche.

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

Per convertire un CDB utilizzando la configurazione single-tenant in una configurazione multi-tenant, specifica nel comando. `--multi-tenant` AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)

L'esempio seguente converte l'istanza database denominata `my-st-cdb` dalla configurazione a tenant singolo alla configurazione multi-tenant. L'opzione `--apply-immediately` è obbligatoria.

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

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

```
aws rds modify-db-instance --region us-east-1 ^
    --db-instance-identifier my-st-cdb ^
    --multi-tenant ^
    --apply-immediately
```
L'output è simile al seguente.  

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