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 ad Amazon DocumentDB serverless **Topics** + [Migrazione dei cluster DocumentDB esistenti a quelli serverless](#w2aac51c19b5) + [Migrazione da MongoDB a DocumentDB serverless](#w2aac51c19b7) ## Migrazione dei cluster DocumentDB esistenti a quelli serverless ### Aggiornamento della versione del motore di un cluster Se il cluster di cui hai eseguito il provisioning esegue una versione inferiore del motore che non supporta DocumentDB serverless, devi prima aggiornare il cluster a una versione del motore supportata. Per ulteriori informazioni, consulta [Aggiornamento della versione principale in-place di Amazon DocumentDB](docdb-mvu.md). ### Migrazione di un cluster con provisioning su DocumentDB serverless Per passare da un cluster con provisioning a utilizzare DocumentDB serverless, segui questi passaggi: 1. Verifica se la versione del motore del cluster fornito deve essere aggiornata per essere utilizzata con DocumentDB serverless. 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. Consulta [Aggiornamento della versione principale in-place 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 da. [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 di lettura 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) Esegui un'operazione di failover per rendere un'istanza serverless di DocumentDB il cluster writer. Consulta [Failover di Amazon DocumentDB](failover.md). 1. (Facoltativo) Converti tutte le istanze Amazon DocumentDB con provisioning rimanenti in istanze serverless DocumentDB (vedi[Modifica della classe di un'istanza](db-instance-classes.md#db-instance-class-changing)) o rimuovile dal cluster (vedi). [Eliminazione di un'istanza Amazon DocumentDB](db-instance-delete.md) ------ #### [ Using the Console di gestione AWS ] L'esempio di Console di gestione AWS configurazione seguente mostra il processo di migrazione utilizzando un cluster con provisioning di Amazon DocumentDB su cui è in esecuzione Amazon DocumentDB 5.0.0, che non richiede un aggiornamento della versione del motore per iniziare a utilizzare DocumentDB serverless. Il cluster è denominato e inizia con tre istanze predisposte 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 (![Menu button.](https://docs.aws.amazon.com/it_it/documentdb/latest/devguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. Viene visualizzata la ** tabella ** Clusters. 1. Nella ** tabella ** Clusters, 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 della 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. ** Continua ad aggiungere istanze fino a raggiungere il numero desiderato di nuove istanze. In questo esempio, vengono create tre nuove istanze serverless. 1. Scegli **Crea**. La creazione dell'istanza richiede diversi minuti. È possibile utilizzare la console o la AWS CLI per visualizzare lo stato dell'istanza. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md). 1. Tornando alla ** tabella ** Clusters, seleziona le caselle di controllo di tutte e tre le istanze originariamente assegnate. 1. Scegli **Azioni**, quindi **Elimina**. Durante l'eliminazione, viene eseguito automaticamente un failover per promuovere una delle istanze rimanenti come writer. Dopo alcuni minuti, il processo di eliminazione è completato. Il cluster esistente ora contiene tre istanze serverless di DocumentDB (come definito nella colonna ** Dimensioni**). ------ #### [ Using the AWS CLI ] L'esempio di AWS CLI configurazione seguente mostra il processo di migrazione utilizzando un cluster fornito da Amazon DocumentDB su cui è in esecuzione Amazon DocumentDB 5.0.0, che non richiede un aggiornamento della versione del motore per iniziare a utilizzare DocumentDB serverless. Il cluster è denominato e inizia con tre istanze predisposte 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, sostituisci ciascuna {{user input placeholder}} con le tue informazioni o i tuoi parametri di configurazione. 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: `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 ``` Eseguite un failover per rendere la nuova `sample-serverless-instance-1` istanza il cluster writer: ``` 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 il cluster writer. Verificalo 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 originali assegnate: ``` 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 serverless, proprio come con Amazon DocumentDB con provisioning. Per ulteriori informazioni, consulta [Migrazione e aggiornamento di Amazon DocumentDB](docdb-migration.md).