

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à.

# Configurazione di un CDB RDS per Oracle
<a name="oracle-cdb.configuring"></a>

La configurazione di un CDB è simile alla configurazione di un database non CDB. 

**Topics**
+ [Creazione di un'istanza CDB RDS per Oracle](#Oracle.Concepts.single-tenant.creation)
+ [Connessione a un PDB nel CDB RDS per Oracle](#Oracle.Concepts.connecting.pdb)

## Creazione di un'istanza CDB RDS per Oracle
<a name="Oracle.Concepts.single-tenant.creation"></a>

In RDS per Oracle, la procedura per la creazione di un’istanza CDB è quasi identica alla creazione di un database non CDB. La differenza risiede nella selezione dell'architettura multitenant Oracle quando viene creata l'istanza database e viene scelta anche la configurazione dell'architettura: multi-tenant o tenant singolo. Se si creano i tag quando si crea un CDB nella configurazione multi-tenant, RDS propaga i tag al database del tenant iniziale. Per creare un CDB, usa l' Console di gestione AWS API AWS CLI, the o RDS.

### Console
<a name="Oracle.Concepts.single-tenant.creation.console"></a>

**Creazione di un'istanza database**

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, scegli l'istanza CDB Regione AWS in cui desideri creare l'istanza CDB.

1. Nel riquadro di navigazione, scegliere **Databases** (Database).

1. Scegliere **Create database (Crea database)**.

1. In **Choose a database creation method (Seleziona metodo di creazione del database)**, scegliere **Standard Create (Creazione standard)**.

1. In **Engine options (Opzioni motore)**, selezionare **Oracle**. 

1. In **Tipo di gestione del database**, selezionare **Amazon RDS**.

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

1. Per **Configurazione dell'architettura**, effettua una delle seguenti operazioni:
   + Scegli **Configurazione multi-tenant** e procedi con il passaggio successivo.
   + Scegli **Configurazione a tenant singolo** e vai alla fase 11.

1. (Configurazione multi-tenant) Per **Impostazioni globali del tenant**, apporta le seguenti modifiche:
   + Per **Nome del database tenant** immetti il nome del PDB. Il nome del PDB deve essere diverso dal nome del CDB, che per impostazione predefinita è `RDSCDB`.
   + Per **Nome utente principale del database tenant**, specifica il nome dell'utente principale del PDB. Non è possibile utilizzare il nome utente principale del database del tenant per accedere al CDB.
   + Per **Gestione delle credenziali**, scegli una delle seguenti opzioni:
     + **Gestito in Gestione dei segreti AWS**

       La password gestita è quella utilizzata per il database del tenant iniziale anziché quella per l’istanza. In **Seleziona la chiave di crittografia**, scegli una chiave KMS creata da Secrets Manager o una chiave creata personalmente. 
**Nota**  
Consigliamo Gestione dei segreti AWS come tecnica più sicura per la gestione delle credenziali. Si applicano costi aggiuntivi. Per ulteriori informazioni, consulta [Gestione delle password con Amazon RDS e Gestione dei segreti AWS](rds-secrets-manager.md).
     + **Gestione autonoma**

       Per specificare una password, deseleziona la casella di controllo **Genera automaticamente una password** se è selezionata. Inserisci la stessa password in **Password master** e **Conferma password**.
   + Per **Set di caratteri del database tenant**, scegli un set di caratteri per il PDB. È possibile scegliere un set di caratteri del database del tenant diverso dal set di caratteri del CDB.

     Il set di caratteri PDB predefinito è **AL32UTF8**. Se scegli un set di caratteri del PDB non predefinito, la creazione del CDB potrebbe essere più lenta. 
**Nota**  
Non è possibile specificare più database del tenant durante l’operazione di creazione. Il CDB ha un solo PDB quando viene creato. È possibile aggiungere PDBs a un CDB esistente in un'operazione separata.

1. (Configurazione a tenant singolo) Scegli le impostazioni desiderate in base alle opzioni elencate in [Impostazioni per istanze database](USER_CreateDBInstance.Settings.md):

   1. Nella sezione **Settings (Impostazioni)**, aprire **Credential Settings (Impostazioni credenziali)**. Quindi, esegui queste operazioni:

     1. In **Nome utente master**, immettere il nome di un utente locale nel PDB. Non è possibile utilizzare il nome utente master per accedere alla root del CDB.

     1. Per **Gestione delle credenziali**, scegli una delle seguenti opzioni:
        + **Gestito in Gestione dei segreti AWS**

          In **Seleziona la chiave di crittografia**, scegli una chiave KMS creata da Secrets Manager o una chiave creata personalmente. 
**Nota**  
Consigliamo Gestione dei segreti AWS come tecnica più sicura per la gestione delle credenziali. Si applicano costi aggiuntivi. Per ulteriori informazioni, consulta [Gestione delle password con Amazon RDS e Gestione dei segreti AWS](rds-secrets-manager.md).
        + **Gestione autonoma**

          Per specificare una password, deseleziona la casella di controllo **Genera automaticamente una password** se è selezionata. Inserisci la stessa password in **Password master** e **Conferma password**.

1. Per le restanti sezioni, specifica le impostazioni dell'istanza database. Per informazioni su ciascuna impostazione, consulta [Impostazioni per le istanze database](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html).

1. Scegliere **Crea database**.

### AWS CLI
<a name="Oracle.Concepts.single-tenant.creation.cli"></a>

Per creare un CDB nella configurazione multi-tenant, utilizzate il [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)comando con i seguenti parametri:
+ `--db-instance-identifier`
+ `--db-instance-class`
+ `--engine { oracle-ee-cdb | oracle-se2-cdb }`
+ `--master-username`
+ `--master-user-password` o `--manage-master-user-password`
+ `--multi-tenant` (per la configurazione a tenant singolo, non specificare `multi-tenant` o specifica `--no-multi-tenant`)
+ `--allocated-storage`
+ `--backup-retention-period`

Per informazioni su ciascuna impostazione, consulta [Impostazioni per istanze database](USER_CreateDBInstance.Settings.md).

L'esempio seguente crea un'istanza DB RDS for Oracle denominata *my-cdb-inst* nella configurazione multi-tenant. Se si specifica `--no-multi-tenant` o non si specifica `--multi-tenant`, la configurazione CDB predefinita è a tenant singolo. Il motore è `oracle-ee-cdb`: un comando che specifica `oracle-ee` e `--multi-tenant` non riesce con un errore. Il database dei tenant iniziali è denominato. *mypdb*

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

```
 1. aws rds create-db-instance \
 2.     --engine oracle-ee-cdb \
 3.     --db-instance-identifier my-cdb-inst \
 4.     --multi-tenant \
 5.     --db-name mypdb \
 6.     --allocated-storage 250 \
 7.     --db-instance-class db.t3.large \
 8.     --master-username pdb_admin \
 9.     --manage-master-user-password \
10.     --backup-retention-period 3
```
Per Windows:  

```
 1. aws rds create-db-instance ^
 2.     --engine oracle-ee-cdb ^
 3.     --db-instance-identifier my-cdb-inst ^
 4.     --multi-tenant ^
 5.     --db-name mypdb ^
 6.     --allocated-storage 250 ^
 7.     --db-instance-class db.t3.large ^
 8.     --master-username pdb_admin ^
 9.     --manage-master-user-password \ ^
10.     --backup-retention-period 3
```
Specifica una password diversa dal prompt mostrato qui come best practice per la sicurezza.
Questo comando genera un output simile al seguente. Il nome del database, il set di caratteri, il set di caratteri nazionali, l’utente master e il relativo segreto non sono inclusi nell’output. È possibile visualizzare queste informazioni utilizzando il comando CLI `describe-tenant-databases`.  

```
 1. {
 2.     "DBInstance": {
 3.         "DBInstanceIdentifier": "my-cdb-inst",
 4.         "DBInstanceClass": "db.t3.large",
 5.         "MultiTenant": true,
 6.         "Engine": "oracle-ee-cdb",
 7.         "DBResourceId": "db-ABCDEFGJIJKLMNOPQRSTUVWXYZ",
 8.         "DBInstanceStatus": "creating",
 9.         "AllocatedStorage": 250,
10.         "PreferredBackupWindow": "04:59-05:29",
11.         "BackupRetentionPeriod": 3,
12.         "DBSecurityGroups": [],
13.         "VpcSecurityGroups": [
14.             {
15.                 "VpcSecurityGroupId": "sg-0a1bcd2e",
16.                 "Status": "active"
17.             }
18.         ],
19.         "DBParameterGroups": [
20.             {
21.                 "DBParameterGroupName": "default.oracle-ee-cdb-19",
22.                 "ParameterApplyStatus": "in-sync"
23.             }
24.         ],
25.         "DBSubnetGroup": {
26.             "DBSubnetGroupName": "default",
27.             "DBSubnetGroupDescription": "default",
28.             "VpcId": "vpc-1234567a",
29.             "SubnetGroupStatus": "Complete",
30.             ...
```

### API RDS
<a name="Oracle.Concepts.single-tenant.creation.api"></a>

Per creare un'istanza DB utilizzando l'API Amazon RDS, chiama l'DBInstanceoperazione [Create](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html).

Per informazioni su ciascuna impostazione, consulta [Impostazioni per istanze database](USER_CreateDBInstance.Settings.md). 

## Connessione a un PDB nel CDB RDS per Oracle
<a name="Oracle.Concepts.connecting.pdb"></a>

È possibile utilizzare un'utilità come SQL\$1Plus per connettersi a un PDB. Per scaricare Oracle Instant Client, che include una versione autonoma di SQL\$1Plus, consulta [Download di Oracle Instant Client](https://www.oracle.com/database/technologies/instant-client/downloads.html).

Per stabilire la connessione tra SQL\$1Plus e il PDB, è necessario includere le seguenti informazioni:
+ Nome del PDB
+ Nome utente e password del database
+ Endpoint dell'istanza database
+ Numero della porta

Per informazioni su come trovare le informazioni precedenti, consulta [Esito dell'endpoint dell'istanza database RDS per Oracle](USER_Endpoint.md).

**Example Connessione al PDB tramite SQL\$1Plus**  
Negli esempi seguenti, sostituisci il tuo utente principale con. *master\$1user\$1name* Sostituire inoltre l'endpoint dell'istanza database e quindi includere il numero di porta e il SID Oracle. Il valore SID è il nome del PDB specificato al momento della creazione dell'istanza database e non l'identificatore dell'istanza database.  
Per Linux, macOS o Unix:  

```
1. sqlplus 'master_user_name@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=endpoint)(PORT=port))(CONNECT_DATA=(SID=pdb_name)))'
```
Per Windows:  

```
1. sqlplus master_user_name@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=endpoint)(PORT=port))(CONNECT_DATA=(SID=pdb_name)))
```
Verrà visualizzato un output simile al seguente.  

```
SQL*Plus: Release 19.0.0.0.0 Production on Mon Aug 21 09:42:20 2021
```
Dopo l'immissione della password dell'utente, verrà visualizzato il prompt SQL.  

```
SQL>
```

**Nota**  
Il formato più breve della stringa di connessione (Easy connect o EZCONNECT), ad esempio `sqlplus username/password@LONGER-THAN-63-CHARS-RDS-ENDPOINT-HERE:1521/database-identifier`, potrebbe comportare un limite relativo al numero massimo di caratteri e non deve pertanto essere utilizzato per la connessione. 