

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.

# Utilisation d'une base de données compatible MongoDB comme source pour des migrations de données homogènes dans AWS DMS
<a name="dm-data-providers-source-mongodb"></a>

Vous pouvez utiliser une base de données compatible MongoDB comme source pour les migrations de données homogènes dans. AWS DMS Dans ce cas, votre fournisseur de données source peut être une base de données Amazon EC2 pour MongoDB sur site ou une base de données Amazon DocumentDB (compatible avec MongoDB).

Pour les versions de base de données prises en charge, consultez[Fournisseurs de données sources pour les migrations de données homogènes DMS](CHAP_Introduction.Sources.md#CHAP_Introduction.Sources.HomogeneousDataMigrations).

Les sections suivantes décrivent les prérequis de configuration spécifiques pour les bases de données MongoDB autogérées et les bases de données AWS Amazon DocumentDB gérées par des tiers.

**Topics**
+ [Utilisation d'une base de données MongoDB autogérée comme source pour des migrations de données homogènes dans AWS DMS](#dm-data-providers-source-mongodb-sm)
+ [Utilisation d'une base de données Amazon DocumentDB comme source pour des migrations de données homogènes dans AWS DMS](#dm-data-providers-source-mongodb-aws)
+ [Fonctionnalités d'utilisation d'une base de données compatible MongoDB comme source pour des migrations de données homogènes](#dm-data-providers-source-mongodb-features)
+ [Limitations liées à l'utilisation d'une base de données compatible avec MongoDB comme source pour des migrations de données homogènes](#dm-data-providers-source-mongodb-limitations)
+ [Bonnes pratiques d'utilisation d'une base de données compatible avec MongoDB comme source pour des migrations de données homogènes](#dm-data-providers-source-mongodb-bestpractices)

## Utilisation d'une base de données MongoDB autogérée comme source pour des migrations de données homogènes dans AWS DMS
<a name="dm-data-providers-source-mongodb-sm"></a>

Cette section décrit comment configurer vos bases de données MongoDB hébergées sur site ou sur des instances Amazon EC2.

Vérifiez la version de votre base de données MongoDB source. Assurez-vous qu'elle AWS DMS prend en charge la version de votre base de données MongoDB source, comme décrit dans. [Fournisseurs de données sources pour les migrations de données homogènes DMS](CHAP_Introduction.Sources.md#CHAP_Introduction.Sources.HomogeneousDataMigrations)

Pour effectuer des migrations de données homogènes avec une source MongoDB, vous pouvez créer soit un compte utilisateur avec des privilèges root, soit un utilisateur autorisé uniquement sur la base de données à migrer. Pour plus d'informations sur la création d'utilisateurs, consultez[Autorisations nécessaires lors de l'utilisation de MongoDB comme source pour AWS DMS](CHAP_Source.MongoDB.md#CHAP_Source.MongoDB.PrerequisitesCDC).

Pour utiliser la réplication continue ou le CDC avec MongoDB, AWS DMS il faut accéder au journal des opérations MongoDB (oplog). Pour de plus amples informations, veuillez consulter [Configuration d’un ensemble de réplicas MongoDB pour la CDC](CHAP_Source.MongoDB.md#CHAP_Source.MongoDB.PrerequisitesCDC.ReplicaSet). 

Pour plus d'informations sur les méthodes d'authentification MongoDB, consultez. [Exigences de sécurité lors de l'utilisation de MongoDB comme source pour AWS DMS](CHAP_Source.MongoDB.md#CHAP_Source.MongoDB.Security)

Pour MongoDB en tant que source, les migrations de données homogènes prennent en charge tous les types de données pris en charge par Amazon DocumentDB.

Pour MongoDB en tant que source, pour stocker les informations d'identification des utilisateurs dans Secrets Manager, vous devez les fournir en texte brut, en utilisant le **type Autre type de secrets**. Pour de plus amples informations, veuillez consulter [Utilisation de secrets pour accéder aux points de AWS Database Migration Service terminaison](security_iam_secretsmanager.md).

L'exemple de code suivant montre comment stocker des secrets de base de données en texte brut.

```
{
  "username": "dbuser",
  "password": "dbpassword"
}
```

## Utilisation d'une base de données Amazon DocumentDB comme source pour des migrations de données homogènes dans AWS DMS
<a name="dm-data-providers-source-mongodb-aws"></a>

Cette section décrit comment configurer vos instances de base de données Amazon DocumentDB afin de les utiliser comme source pour des migrations de données homogènes.

Utilisez le nom d'utilisateur principal de l'instance Amazon DocumentDB comme compte utilisateur du fournisseur de données source compatible MongoDB pour des migrations de données homogènes vers. AWS DMS Le compte d'utilisateur principal a les rôles nécessaires qui lui permettent de configurer la capture des données modifiées. Si vous utilisez un compte autre que le compte utilisateur principal, le compte doit avoir le rôle root. Pour plus d'informations sur la création d'un utilisateur en tant que compte root, consultez[Définition des autorisations pour utiliser Amazon DocumentDB en tant que source](CHAP_Source.DocumentDB.md#CHAP_Source.DocumentDB.Permissions).

Pour activer la réplication logique, définissez le `change_stream_log_retention_duration` paramètre de votre groupe de paramètres de base de données sur un paramètre adapté à votre charge de travail transactionnelle. La modification de ce paramètre statique nécessite que vous redémarriez votre instance de base de données pour prendre effet. Avant de commencer la migration des données pour tous les types de tâches, y compris le chargement complet uniquement, activez les flux de modification Amazon DocumentDB pour toutes les collections d'une base de données donnée, ou uniquement pour certaines collections. Pour plus d'informations sur l'activation des flux de modifications pour Amazon DocumentDB, consultez la section [Activation des flux de modifications](https://docs.aws.amazon.com/documentdb/latest/developerguide/change_streams.html#change_streams-enabling) dans le guide du développeur *Amazon DocumentDB*. 

**Note**  
AWS DMS utilise le flux de modifications Amazon DocumentDB pour capturer les modifications lors de la réplication en cours. Si Amazon DocumentDB supprime les enregistrements du flux de modifications avant que DMS ne les lise, vos tâches échoueront. Nous vous recommandons de définir le `change_stream_log_retention_duration` paramètre pour conserver les modifications pendant au moins 24 heures.

Pour utiliser Amazon DocumentDB pour une migration homogène des données, stockez les informations d'identification utilisateur dans Secrets Manager sous **Identifiants pour la base de données Amazon DocumentDB**.

## Fonctionnalités d'utilisation d'une base de données compatible MongoDB comme source pour des migrations de données homogènes
<a name="dm-data-providers-source-mongodb-features"></a>
+ Vous pouvez migrer tous les index secondaires pris en charge par Amazon DocumentDB pendant la phase de chargement complet.
+ AWS DMS migre les collections en parallèle. les migrations de données homogènes calculent les segments au moment de l'exécution en fonction de la taille moyenne de chaque document de la collection pour des performances optimales.
+ DMS peut répliquer les index secondaires que vous créez lors de la phase CDC. DMS prend en charge cette fonctionnalité dans la version 6.0 de MongoDB.
+ DMS prend en charge les documents dont le niveau d'imbrication est supérieur à 97.

## Limitations liées à l'utilisation d'une base de données compatible avec MongoDB comme source pour des migrations de données homogènes
<a name="dm-data-providers-source-mongodb-limitations"></a>
+ Les documents ne peuvent pas avoir de nom de champ avec un `$` préfixe.
+ AWS DMS ne prend pas en charge la migration des collections de séries chronologiques.
+ AWS DMS ne prend pas en charge `create` `drop` les événements `rename collection` DDL ou DDL pendant la phase CDC.
+ AWS DMS ne prend pas en charge les types de données incohérents dans la collection pour le champ. `_id` Par exemple, la collection non prise en charge suivante comporte plusieurs types de données pour le `_id` champ.

  ```
  rs0 [direct: primary] test> db.collection1.aggregate([
  ...   {
  ...     $group: {
  ...       _id: { $type: "$_id" },
  ...       count: { $sum: 1 }
  ...     }
  ...   }
  ... ])
  [ { _id: 'string', count: 6136 }, { _id: 'objectId', count: 848033 } ]
  ```
+ Pour les tâches CDC uniquement, AWS DMS seul le mode de `immediate` démarrage est pris en charge.
+ AWS DMS ne prend pas en charge les documents contenant des UTF8 caractères non valides.
+ AWS DMS ne prend pas en charge les collections fragmentées.

## Bonnes pratiques d'utilisation d'une base de données compatible avec MongoDB comme source pour des migrations de données homogènes
<a name="dm-data-providers-source-mongodb-bestpractices"></a>
+ Pour plusieurs bases de données et collections volumineuses hébergées sur la même instance MongoDB, nous vous recommandons d'utiliser des règles de sélection pour chaque base de données et collection afin de répartir la tâche entre plusieurs tâches et projets de migration de données. Vous pouvez ajuster votre base de données et vos divisions de collecte pour optimiser les performances.