Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Migrer vers Amazon DocumentDB à l'aide du Service AWS de migration de base de données (DMS) : Guide de démarrage rapide
<a name="migration-quick-start"></a>

**Topics**
+ [Préparez la source DMS](#migrate-qs-dma-source)
+ [Configuration du DMS](#migrate-qs-dms-setup)
+ [Activer la compression DocumentDB](#migrate-qs-comp)
+ [Création d'une tâche de réplication](#migrate-qs-create)
+ [Surveiller la progression](#migrate-qs-monitor)
+ [Informations supplémentaires](#migrate-qs-info)

## Préparez la source DMS
<a name="migrate-qs-dma-source"></a>

Consultez [Activer les flux de changement](change_streams.md#change_streams-enabling) pour activer les flux de modifications DocumentDB ou pour activer le journal MongoDB pour prendre en charge la capture des données de modification (CDC) par DMS.
+ La source DMS doit conserver toutes les modifications en cours jusqu'à ce que le chargement complet du DMS soit terminé pour toutes les collections incluses.
+ Les flux de modifications de DocumentDB sont basés sur le temps. Assurez-vous que le `change_stream_log_retention_duration` paramètre est suffisamment grand pour couvrir le temps nécessaire au chargement complet.
+ Le MongoDB Oplog est de taille fixe. Assurez-vous qu'il est dimensionné pour supporter toutes les opérations à pleine charge.

## Configuration du DMS
<a name="migrate-qs-dms-setup"></a>

Créez une instance DMS, des points de terminaison source et cible et testez chaque point de terminaison.

## Activer la compression DocumentDB
<a name="migrate-qs-comp"></a>

Activez la compression en attachant un groupe de paramètres personnalisé à votre cluster DocumentDB et en mettant à jour le paramètre default\$1collection\$1compression pour qu'il soit activé. Pour plus d’informations, consultez [Gestion de la compression de documents au niveau de la collection](doc-compression.md).

## Création d'une tâche de réplication
<a name="migrate-qs-create"></a>

1. **Dans le volet de navigation de la console DMS, choisissez **Migrer ou répliquer**, puis Tâches.**

1. Choisissez **Créer tâche**.

1. Sur la page **Créer une tâche**, dans la section **Configuration des tâches** :
   + Entrez un **identifiant de tâche** unique et significatif (par exemple, mongodb-docdb-replication « »).
   + Choisissez le point de terminaison source que vous avez créé précédemment dans le menu déroulant **point de terminaison de la base de données source**.
   + Choisissez le point de terminaison cible que vous avez créé précédemment dans le menu déroulant **Point de terminaison de la base de données cible**.
   + Pour **Type de tâche**, choisissez **Migrer et répliquer**.

1. Dans la section **Paramètres** :
   + Pour les **journaux des tâches**, cochez la case **Activer CloudWatch** les journaux.
   + Pour le **mode édition** (en haut de la section), choisissez l'**éditeur JSON** et définissez les attributs suivants :
     + `ParallelApplyThreads`Réglé sur 5 (moins`TargetMetadata`). Cela permet environ 1 000 insert/update/delete opérations par seconde dans le CDC.
     + `MaxFullLoadSubTasks`Réglé sur 16 (moins`FullLoadSettings`). Envisagez de l'augmenter en fonction de la taille de votre instance.
     + Pour les collections volumineuses (plus de 100 Go), activez le partitionnement automatique (sous Table Mapping et sous l'`parallel-load`attribut) :
       + « type » : « partitions automatiques »
       + number-of-partitions« : 16

## Surveiller la progression
<a name="migrate-qs-monitor"></a>

Utilisez la AWS DMS console ou créez un tableau de bord personnalisé ([outil de tableau de bord) pour](https://github.com/awslabs/amazon-documentdb-tools/tree/master/monitoring/docdb-dashboarder) suivre la migration. Concentrez-vous sur les indicateurs suivants :
+ **FullLoadThroughputBandwidthTarget**— Mesure la bande passante réseau (en Kb/seconde) utilisée par DMS lors du transfert de données vers la base de données cible pendant la phase de chargement complet de la migration.
+ **CDCLatencyCible** : mesure le délai (en secondes) entre le moment où une modification se produit dans la base de données source et le moment où cette modification est appliquée à la base de données cible.
+ **CDCThroughputRowsTarget**— Mesure le nombre de lignes par seconde que DMS applique à la base de données cible pendant la phase de réplication en cours de la migration.

## Informations supplémentaires
<a name="migrate-qs-info"></a>

Pour plus d'informations sur Amazon DocumentDB et AWS DMS consultez : Voir pour plus d'informations.
+ [Manuel de migration vers Amazon DocumentDB](docdb-migration-runbook.md)
+ [Migration de MongoDB vers Amazon DocumentDB](https://docs.aws.amazon.com/dms/latest/sbs/chap-mongodb2documentdb.html)