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.
# Migration vers Amazon DocumentDB sans serveur
**Topics**
+ [Migration de clusters DocumentDB existants vers des clusters sans serveur](#w2aac41c19b5)
+ [Migration de MongoDB vers DocumentDB sans serveur](#w2aac41c19b7)
## Migration de clusters DocumentDB existants vers des clusters sans serveur
### Mise à niveau de la version du moteur d'un cluster
Si votre cluster provisionné exécute une version inférieure du moteur qui ne prend pas en charge DocumentDB sans serveur, vous devez d'abord mettre à niveau le cluster vers une version de moteur prise en charge. Pour de plus amples informations, veuillez consulter [Mise à niveau sur place de la version majeure d'Amazon DocumentDB](docdb-mvu.md).
### Migration d'un cluster provisionné vers DocumentDB sans serveur
Pour changer un cluster provisionné afin d'utiliser DocumentDB sans serveur, procédez comme suit :
1. Vérifiez si la version du moteur du cluster provisionné doit être mise à niveau pour être utilisée avec DocumentDB sans serveur. Consultez [Exigences et limites de DocumentDB sans serveur](docdb-serverless-limitations.md).
**Note**
Si le cluster provisionné exécute une version du moteur qui n'est pas disponible pour DocumentDB sans serveur, mettez à niveau la version du moteur du cluster. Consultez [Mise à niveau sur place de la version majeure d'Amazon DocumentDB](docdb-mvu.md).
1. Définissez la configuration de mise à l’échelle du cluster. Pour plus de détails sur le choix de la configuration de dimensionnement, consultez[Choix de la plage de capacité de dimensionnement pour un cluster sans serveur DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing). Pour modifier la configuration de dimensionnement d'un cluster, consultez[Affichage et modification de la configuration de la plage de capacités d'évolutivité d'un cluster](docdb-serverless-managing.md#docdb-serverless-range-config).
1. Configurez toutes les autres propriétés du cluster pour tenir compte des exigences et des limites de DocumentDB sans serveur issues de. [Exigences et limites de DocumentDB sans serveur](docdb-serverless-limitations.md)
1. Ajoutez une ou plusieurs instances sans serveur DocumentDB au cluster. Suivez la procédure décrite dans [Ajouter une instance sans serveur Amazon DocumentDB](docdb-serverless-create-cluster.md#docdb-serverless-adding-instance).
**Note**
Dans certains cas, il se peut que vous disposiez déjà d'une ou de plusieurs instances de lecteur provisionnées dans le cluster. Dans ce cas, vous pouvez choisir de convertir l'un des lecteurs en une instance sans serveur DocumentDB au lieu de créer une nouvelle instance. Pour ce faire, suivez la procédure décrite dans [Modification de la classe d'une instance](db-instance-classes.md#db-instance-class-changing).
1. (Facultatif) Effectuez une opération de basculement pour faire d'une instance de DocumentDB sans serveur le rédacteur du cluster. Consultez [Basculement d'Amazon DocumentDB](failover.md).
1. (Facultatif) Convertissez toutes les instances Amazon DocumentDB provisionnées restantes en instances sans serveur DocumentDB ([Modification de la classe d'une instance](db-instance-classes.md#db-instance-class-changing)voir) ou supprimez-les du cluster (voir). [Suppression d'une instance Amazon DocumentDB](db-instance-delete.md)
------
#### [ Using the AWS Management Console ]
L'exemple de AWS Management Console configuration suivant montre le processus de migration à l'aide d'un cluster provisionné Amazon DocumentDB qui exécute Amazon DocumentDB 5.0.0, qui ne nécessite pas de mise à niveau de la version du moteur pour commencer à utiliser DocumentDB sans serveur. Le cluster est nommé `sample` et commence par trois instances provisionnées nommées `sample``sample2`, et`sample3`. Dans cet exemple, ces trois instances seront remplacées par trois instances sans serveur.
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
Le tableau **Clusters** apparaît.
1. Dans le tableau **Clusters**, cochez la case du cluster auquel vous souhaitez ajouter une instance sans serveur.
1. Choisissez **Actions**, puis **Add instances (Ajouter des instances)**.
1. Dans la boîte de dialogue **Ajouter des instances**, sélectionnez **Serverless** dans la section de **classe d'instance** de base de données pour chaque nouvelle instance sans serveur que vous souhaitez créer.
1. Pour les **paramètres de capacité sans serveur**, définissez la configuration de dimensionnement en fonction de la description de la capacité dans la boîte de dialogue.
1. (Facultatif) Pour ajouter une autre instance, choisissez **Ajouter une instance**. Continuez à ajouter des instances jusqu'à ce que vous ayez atteint le nombre de nouvelles instances souhaité.
Dans cet exemple, trois nouvelles instances sans serveur sont créées.
1. Choisissez **Créer**.
La création d'une instance prend quelques minutes. Vous pouvez utiliser la console ou le AWS CLI pour consulter le statut de l'instance. Pour plus d'informations, consultez [Surveillance de l'état d'un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
1. Pour revenir au tableau **Clusters**, cochez les cases des trois instances provisionnées d'origine.
1. Choisissez **Actions**, puis **Supprimer**.
Lors de la suppression, un basculement est automatiquement effectué pour promouvoir l'une des instances restantes en tant que rédactrice. Après quelques minutes, le processus de suppression est terminé. Le cluster existant contient désormais trois instances sans serveur DocumentDB (telles que définies dans la colonne **Taille**).
------
#### [ Using the AWS CLI ]
L'exemple de AWS CLI configuration suivant montre le processus de migration à l'aide d'un cluster provisionné Amazon DocumentDB qui exécute Amazon DocumentDB 5.0.0, qui ne nécessite pas de mise à niveau de la version du moteur pour commencer à utiliser DocumentDB sans serveur. Le cluster est nommé `sample` et commence par trois instances provisionnées nommées `sample``sample2`, et`sample3`. Dans cet exemple, ces trois instances seront remplacées par trois instances sans serveur. Le cluster est nommé `sample-cluster` et commence par deux instances provisionnées nommées `sample-provisioned-instance-1` et une instance `sample-provisioned-instance-2` d'écriture et une instance de lecteur.
Dans l'exemple suivant, remplacez chacun *user input placeholder* par vos propres informations ou paramètres de configuration.
Utilisez cette `aws docdb describe-db-clusters` opération pour déterminer l'état d'un cluster. Le code suivant trouve l'état du cluster `sample-cluster` et affiche les résultats dans un tableau :
```
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 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Ajoutez la configuration de dimensionnement pour le cluster :
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16
```
Ajoutez les instances sans serveur. Dans cet exemple, les nouvelles instances sans serveur `sample-serverless-instance-2` sont nommées `sample-serverless-instance-1` et ajoutées :
```
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
```
Entrez ce qui suit pour attendre que les instances sans serveur soient disponibles avant de continuer :
```
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
```
Effectuez un basculement pour faire de la nouvelle `sample-serverless-instance-1` instance le rédacteur du cluster :
```
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-1
```
Le basculement prend quelques secondes, après quoi sample-serverless-instance -1 devient le rédacteur du cluster. Vérifiez cela à l'aide des données suivantes :
```
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 |
+--------------------------------+---------------------------------+------------------+----------------+
```
Enfin, supprimez les instances provisionnées d'origine :
```
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-1
aws docdb delete-db-instance \
--db-instance-identifier sample-provisioned-instance-2
```
------
## Migration de MongoDB vers DocumentDB sans serveur
Vous pouvez migrer vos bases de données MongoDB vers DocumentDB sans serveur, comme avec Amazon DocumentDB provisionné. Pour de plus amples informations, veuillez consulter [Migration vers Amazon DocumentDB](docdb-migration.md).