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à.
# Migrazione a Amazon DocumentDB serverless
**Topics**
+ [Migrazione dei cluster DocumentDB esistenti verso i cluster serverless](#w2aac41c19b5)
+ [Migrazione da MongoDB a DocumentDB serverless](#w2aac41c19b7)
## Migrazione dei cluster DocumentDB esistenti verso i cluster serverless
### Aggiornamento della versione del motore di un cluster
Se il cluster a cui è stato assegnato il provisioning utilizza una versione precedente del motore che non supporta DocumentDB serverless, è necessario prima aggiornare il cluster a una versione del motore supportata. Per ulteriori informazioni, consulta [Aggiornamento immediato della versione principale di Amazon DocumentDB](docdb-mvu.md).
### Migrazione di un cluster fornito a DocumentDB serverless
Per passare da un cluster a cui è stato assegnato il provisioning all'utilizzo di DocumentDB serverless, segui questi passaggi:
1. Verifica se la versione del motore del cluster fornito deve essere aggiornata per essere utilizzata con DocumentDB serverless. Per informazioni, consulta [Requisiti e limitazioni per DocumentDB serverless](docdb-serverless-limitations.md).
**Nota**
Se il cluster fornito esegue una versione del motore che non è disponibile per DocumentDB serverless, aggiorna la versione del motore del cluster. Per informazioni, consulta [Aggiornamento immediato della versione principale di Amazon DocumentDB](docdb-mvu.md).
1. Definire la configurazione di dimensionamento per il cluster. Per i dettagli sulla scelta della configurazione di scalabilità, vedere. [Scelta dell'intervallo di capacità di scalabilità per un cluster serverless DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing) Per modificare la configurazione di scalabilità per un cluster, vedere. [Visualizzazione e modifica della configurazione dell'intervallo di capacità di scalabilità di un cluster](docdb-serverless-managing.md#docdb-serverless-range-config)
1. Configura qualsiasi altra proprietà del cluster per tenere conto dei requisiti e delle limitazioni serverless di DocumentDB. [Requisiti e limitazioni per DocumentDB serverless](docdb-serverless-limitations.md)
1. Aggiungi una o più istanze serverless di DocumentDB al cluster. Segui la procedura riportata in [Aggiungere un'istanza serverless di Amazon DocumentDB](docdb-serverless-create-cluster.md#docdb-serverless-adding-instance).
**Nota**
In alcuni casi, è possibile che nel cluster siano già presenti una o più istanze Reader predisposte. In tal caso, puoi scegliere di convertire uno dei lettori in un'istanza serverless di DocumentDB invece di creare una nuova istanza. A tale scopo, segui la procedura in [Modifica della classe di un'istanza](db-instance-classes.md#db-instance-class-changing).
1. (Facoltativo) Eseguite un'operazione di failover per rendere un'istanza DocumentDB serverless il cluster writer. Per informazioni, consulta [Failover di Amazon DocumentDB](failover.md).
1. (Facoltativo) Converti tutte le istanze Amazon DocumentDB con provisioning rimanenti in istanze serverless DocumentDB [Modifica della classe di un'istanza](db-instance-classes.md#db-instance-class-changing) (vedi) o rimuovile dal cluster (vedi). [Eliminazione di un'istanza Amazon DocumentDB](db-instance-delete.md)
------
#### [ Using the Console di gestione AWS ]
Il seguente esempio di Console di gestione AWS configurazione mostra il processo di migrazione utilizzando un cluster con provisioning di Amazon DocumentDB che esegue Amazon DocumentDB 5.0.0, che non richiede l'aggiornamento della versione del motore per iniziare a utilizzare DocumentDB serverless. Il cluster è denominato e inizia con tre istanze assegnate denominate`sample`, e. `sample` `sample2` `sample3` In questo esempio, queste tre istanze verranno sostituite da tre istanze serverless.
1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB.
1. Nel pannello di navigazione scegliere **Cluster**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
Viene visualizzata la tabella **Clusters**.
1. Nella tabella **Cluster**, seleziona la casella di controllo del cluster a cui desideri aggiungere un'istanza serverless.
1. Scegli **Actions (Operazioni)**, quindi **Add instance (Aggiungi istanza)**.
1. Nella finestra di dialogo **Aggiungi istanze**, seleziona **Serverless** nella sezione **Classe di istanza DB per ogni nuova istanza** serverless che desideri creare.
1. Per **le impostazioni della capacità serverless**, imposta la configurazione di scalabilità in base alla descrizione della capacità nella finestra di dialogo.
1. (Facoltativo) Per aggiungere un'altra istanza, scegli **Aggiungi** istanza. Continuate ad aggiungere istanze fino a raggiungere il numero desiderato di nuove istanze.
In questo esempio, vengono create tre nuove istanze serverless.
1. Scegli **Create** (Crea).
La creazione dell'istanza richiede diversi minuti. È possibile utilizzare la console o il AWS CLI per visualizzare lo stato dell'istanza. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
1. Tornando alla tabella **Cluster**, seleziona le caselle di controllo di tutte e tre le istanze fornite originariamente.
1. Scegli **Azioni**, quindi **Elimina**.
Durante l'eliminazione, viene eseguito automaticamente un failover per promuovere una delle istanze rimanenti al ruolo di writer. Dopo alcuni minuti, il processo di eliminazione è completato. **Il cluster esistente contiene ora tre istanze serverless di DocumentDB (come definito nella colonna Size).**
------
#### [ Using the AWS CLI ]
Il seguente esempio di AWS CLI configurazione mostra il processo di migrazione utilizzando un cluster con provisioning di Amazon DocumentDB che esegue Amazon DocumentDB 5.0.0, che non richiede l'aggiornamento della versione del motore per iniziare a utilizzare DocumentDB serverless. Il cluster è denominato e inizia con tre istanze assegnate denominate`sample`, e. `sample` `sample2` `sample3` In questo esempio, queste tre istanze verranno sostituite da tre istanze serverless. Il cluster è denominato `sample-cluster` e inizia con due istanze assegnate denominate `sample-provisioned-instance-1` and`sample-provisioned-instance-2`, un'istanza writer e un'istanza reader.
Nell'esempio seguente, sostituite ognuna *user input placeholder* con informazioni o parametri di configurazione personalizzati.
Utilizzate l'`aws docdb describe-db-clusters`operazione per determinare lo stato di un cluster. Il codice seguente trova lo stato del cluster `sample-cluster` e restituisce i risultati in una tabella:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Aggiungi la configurazione di scalabilità per il cluster:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16
```
Aggiungi le istanze serverless. In questo esempio, vengono aggiunte nuove istanze serverless `sample-serverless-instance-1` denominate e aggiunte: `sample-serverless-instance-2`
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-1 \
--db-instance-class db.serverless \
--engine docdb
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-serverless-instance-2 \
--db-instance-class db.serverless \
--engine docdb
```
Inserisci quanto segue per attendere che le istanze serverless siano disponibili prima di procedere:
```
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-1
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-2
```
Esegui un failover per rendere la nuova `sample-serverless-instance-1` istanza lo scrittore del cluster:
```
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-1
```
Il completamento del failover richiede alcuni secondi, dopodiché sample-serverless-instance -1 diventa lo scrittore del cluster. Verificatelo con il seguente input:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].DBClusterMembers' \
--output table
```
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-provisioned-instance-2 | False | 1 |
| in-sync | sample-provisioned-instance-1 | False | 1 |
| in-sync | sample-serverless-instance-2 | False | 1 |
| in-sync | sample-serverless-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Infine, elimina le istanze fornite originariamente:
```
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-1
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-2
```
------
## Migrazione da MongoDB a DocumentDB serverless
Puoi migrare i tuoi database MongoDB su DocumentDB senza server, proprio come con Amazon DocumentDB fornito. Per ulteriori informazioni, consulta [Migrazione ad Amazon DocumentDB](docdb-migration.md).