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

Guida alla migrazione: da MongoDB ad Amazon DocumentDB

Questo playbook sulla migrazione fornisce risorse e passaggi per aiutarti a migrare da un database MongoDB ad Amazon DocumentDB.

Processo di migrazione

Di seguito sono elencati i passaggi di alto livello generalmente necessari per la migrazione dei dati da un database MongoDB ad Amazon DocumentDB.

Fase 1: Compatibilità e differenze funzionali

Amazon DocumentDB interagisce con le API open source Apache 2.0 MongoDB 3.6, 4.0 e 5.0. Di conseguenza, puoi utilizzare gli stessi driver, applicazioni e strumenti MongoDB con Amazon DocumentDB con modifiche minime o nulle.

Il primo passo consiste nel verificare la compatibilità tra gli operatori e gli indici utilizzati dall'applicazione nel database MongoDB e la loro disponibilità in Amazon DocumentDB, nonché comprendere le differenze funzionali tra di essi.

Compatibilità degli operatori

Utilizza lo strumento di compatibilità Amazon DocumentDB* per scoprire facilmente se la tua applicazione utilizza operatori non supportati nelle sue query. Questo strumento può scansionare i file di registro del server di database MongoDB o il codice sorgente dell'applicazione per fornire un rapporto sugli operatori non supportati. Se riscontri l'utilizzo di operatori non supportati, devi modificare l'applicazione per aggirare gli operatori non supportati.

Per verificare la compatibilità tra gli operatori MongoDB utilizzati nella configurazione e gli operatori Amazon DocumentDB supportati, esegui quanto segue:

git clone https://github.com/awslabs/amazon-documentdb-tools.git
cd amazon-documentdb-tools/compat-tool/
python3 compat.py --version <Amazon DocumentDB version> --directory <mongodb logfiles/source code>

Per ulteriori informazioni, consulta APIsMongoDB, operazioni e tipi di dati supportati in Amazon DocumentDB.

^{* Non supportato ufficialmente da. AWS}

Compatibilità degli indici

Puoi utilizzare lo strumento di indicizzazione Amazon DocumentDB* per scoprire se stai utilizzando tipi di indice non supportati in Amazon DocumentDB. Questo strumento richiede una connessione al database di origine per leggere le definizioni degli indici.

Per questo, è necessario prima scaricare le definizioni degli indici in una directory utilizzando l'--dump-indexesopzione. Quindi esegui lo strumento con l'--show-issuesopzione, fornendo la directory per individuare gli indici incompatibili.

Indici di esportazione:

git clone https://github.com/awslabs/amazon-documentdb-tools.git
sudo pip install -r amazon-documentdb-tools/index-tool/requirements.txt
mkdir <directory to dump index definitions>
python3 migrationtools/documentdb_index_tool.py --dump-indexes --dir <directory> --uri <source-mongodb-uri>

Verifica la presenza di indici incompatibili:

python3 migrationtools/documentdb_index_tool.py --show-issues --dir <dumped-index-definitions-directory>

Se riscontri l'utilizzo di tipi di indice non supportati, devi modificare l'applicazione o il modello di dati per risolvere il problema o continuare senza gli indici incompatibili.

Per ulteriori informazioni sui tipi e sulle proprietà di indice supportati in Amazon DocumentDB, consulta Indici e proprietà degli indici e Come indicizzare su Amazon DocumentDB.

^{* Non supportato ufficialmente da. AWS}

Differenze funzionali

Rivedi Differenze funzionali con MongoDB per familiarizzare con le differenze.

Fase 2: Prova del concetto

Esegui un proof of concept eseguendo la tua applicazione o la tua normale suite di test su Amazon DocumentDB per testare funzionalità e prestazioni. Potrebbe essere necessario popolare il cluster Amazon DocumentDB con dati per eseguire i test. Ad esempio, puoi utilizzare gli mongorestore strumenti mongodump e per copiare i dati dal tuo MongoDB di origine.

Test funzionali

Crea un cluster Amazon DocumentDB (vediCreazione di un cluster Amazon DocumentDB) ed esegui la tua applicazione o la tua suite di test funzionali per verificare se tutti i flussi di lavoro dell'applicazione continuano a funzionare senza problemi su Amazon DocumentDB.

Test delle prestazioni

Esegui test delle prestazioni sulla tua applicazione o suite di test delle prestazioni in esecuzione su Amazon DocumentDB con un carico di lavoro simile a quello di produzione per verificare se la configurazione soddisfa i requisiti di latenza. Ottimizza il carico di lavoro in base alle prestazioni o ridimensiona il cluster Amazon DocumentDB a seconda dei casi. Per ulteriori informazioni, consultare Prestazioni e utilizzo delle risorse e Scalabilità dei cluster Amazon DocumentDB.

È importante dimensionare il cluster Amazon DocumentDB con i tipi di istanza giusti per prestazioni ottimali. Per ulteriori informazioni, consulta le best practice perDimensionamento delle istanze.

Puoi utilizzare il calcolatore di dimensionamento di Amazon DocumentDB* per aiutarti a stimare le dimensioni del tuo cluster Amazon DocumentDB.

^{* Non supportato ufficialmente da. AWS}

Test di failover

Potresti voler osservare come la tua applicazione risponde al riavvio del nodo primario di Amazon DocumentDB, al failover del nodo primario o all'eliminazione di un nodo primario in un cluster a più nodi, nonché quando i nodi di replica vengono riavviati o rimossi. Questo ti aiuterà a confermare che l'applicazione è resiliente a questi eventi. Per ulteriori informazioni, consulta Verifica del Failover.

Per comprendere le eccezioni che un'applicazione dovrebbe tollerare e come gestirle in modo efficiente, consulta Creazione di applicazioni resilienti con Amazon DocumentDB.

Fase 3: Migrazione dei dati

Dopo una dimostrazione di fattibilità riuscita, esegui la migrazione dei dati su Amazon DocumentDB. La maggior parte dei nostri clienti utilizza approcci di migrazione online o offline per migrare i propri dati.

Migrazione online

Utilizzando il metodo di migrazione online, puoi migrare i dati dal tuo database di origine, da pochi gigabyte a più terabyte, verso Amazon DocumentDB con tempi di inattività quasi nulli. Per ulteriori informazioni, consulta AWS Database Migration Service (AWS DMS).

Se stai migrando da un database MongoDB, puoi AWS DMS utilizzarlo per eseguire un caricamento completo e replicare le modifiche in corso.

Per un step-by-step processo, consulta Migrazione ad Amazon DocumentDB con il metodo online.

Ulteriori informazioni sono disponibili nella AWS Database Migration Service sezione Using Amazon DocumentDB as a target for della Guida per l'AWS Database Migration Serviceutente.

Punti da tenere in considerazione conAWS DMS:

Migrazione offline

La migrazione offline è l'approccio più semplice per spostare i database in Amazon DocumentDB. Questo approccio viene utilizzato principalmente per i POC e per i carichi di lavoro che possono richiedere tempi di inattività di scrittura durante la migrazione.

Per un step-by-step processo, consulta Migrare da MongoDB ad Amazon DocumentDB utilizzando il metodo offline.

Fase 4: Convalida dei dati

Una volta completata la migrazione dei dati, convalida la correttezza dei dati per acquisire sicurezza. Nella console delle attività di AWS DMS migrazione, puoi trovare le metriche dei dati migrati. Per ulteriori informazioni, consulta Verificare i dati migrati.

Puoi anche utilizzare Amazon DocumentDB DataDiffer Tool * per convalidare la coerenza dei dati tra le raccolte di origine e di destinazione.

^{* Non supportato ufficialmente da. AWS}

Fase 5: Cutover dell'applicazione

Ciò comporta la modifica della stringa di connessione al database dell'applicazione per utilizzare il cluster Amazon DocumentDB.

Per ulteriori informazioni sulla connessione ad Amazon DocumentDB, consulta. Connessione ad Amazon DocumentDB come set di repliche

Migrazione online

Al termine del caricamento completo dei dati, AWS DMS continua a replicare le modifiche in corso dall'origine ad Amazon DocumentDB. Una volta ripristinate le modifiche e completati i controlli di convalida dei dati, puoi eseguire un cutover su Amazon DocumentDB.

Migrazione offline

Una volta completati i controlli completi di caricamento e convalida dei dati, puoi eseguire il cutover su Amazon DocumentDB.

Risorse aggiuntive

Ecco alcune risorse aggiuntive che potrebbero aiutarti nella migrazione:

^{* Non supportato ufficialmente daAWS.}