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.

Clonage d'un volume pour un cluster Amazon DocumentDB

En utilisant le clonage Amazon DocumentDB, vous pouvez créer un nouveau cluster utilisant le même volume de cluster Amazon DocumentDB et contenant les mêmes données que l'original. Le processus est conçu pour être rapide et rentable. Le nouveau cluster avec son volume de données associé est appelé clone. La création d’un clone est plus rapide et plus économe en espace que la copie physique des données à l’aide d’autres techniques telles que la restauration d’instantané.

Amazon DocumentDB prend en charge la création d'un clone provisionné Amazon DocumentDB à partir d'un cluster Amazon DocumentDB provisionné. Lorsque vous créez un clone en utilisant une configuration de déploiement différente de celle de la source, le clone est créé à l'aide de la dernière version du moteur Amazon DocumentDB de la source.

Lorsque vous créez des clones à partir de vos clusters Amazon DocumentDB, les clones sont créés dans votre compte, AWS le même compte que celui qui possède le cluster Amazon DocumentDB source.

Présentation du clonage Amazon DocumentDB

Amazon DocumentDB utilise un protocole de copie sur écriture pour créer un clone. Ce mécanisme utilise un espace supplémentaire minimal pour créer un clone initial. Lorsque le clone est créé pour la première fois, Amazon DocumentDB conserve une copie unique des données utilisées par le cluster de bases de données source et le nouveau cluster Amazon DocumentDB (cloné). Le stockage supplémentaire est alloué uniquement lorsque des modifications sont apportées aux données (sur le volume de stockage Amazon DocumentDB) par le cluster Amazon DocumentDB source ou le clone du cluster Amazon DocumentDB. Pour en savoir plus sur le protocole de copie sur écriture, consultez Comment fonctionne le clonage Amazon DocumentDB.

Le clonage Amazon DocumentDB est particulièrement utile pour configurer rapidement des environnements de test à l'aide de vos données de production, sans risquer de les corrompre. Vous pouvez utiliser des clones pour de nombreux types d’applications, telles que les suivantes :

Vous pouvez créer plusieurs clones à partir du même cluster Amazon DocumentDB. Vous pouvez également créer plusieurs clones à partir d’un autre clone.

Après avoir créé un clone Amazon DocumentDB, vous pouvez configurer les instances Amazon DocumentDB différemment du cluster Amazon DocumentDB source. Par exemple, il se peut que vous n'ayez pas besoin d'un clone à des fins de développement pour répondre aux mêmes exigences de haute disponibilité que le cluster Amazon DocumentDB de production source. Dans ce cas, vous pouvez configurer le clone avec une seule instance Amazon DocumentDB plutôt qu'avec les multiples instances DB utilisées par le cluster Amazon DocumentDB.

Lorsque vous avez fini d’utiliser le clone à des fins de test, de développement ou autres, vous pouvez le supprimer.

Remarques d'utilisation pour le clonage d'Amazon DocumentDB

Amazon DocumentDB ; le clonage présente actuellement les limites suivantes :

Comment fonctionne le clonage Amazon DocumentDB

Le clonage Amazon DocumentDB fonctionne au niveau de la couche de stockage d'un cluster Amazon DocumentDB. Il utilise un protocole de copie sur écriture qui est à la fois rapide et peu encombrant en termes de support durable sous-jacent prenant en charge le volume de stockage Amazon DocumentDB. Vous pouvez en savoir plus sur les volumes de cluster Amazon DocumentDB dansGestion des clusters Amazon DocumentDB.

Présentation du protocole de copie sur écriture

Un cluster Amazon DocumentDB stocke les données dans les pages du volume de stockage Amazon DocumentDB sous-jacent.

Par exemple, dans le schéma suivant, vous trouverez un cluster Amazon DocumentDB (A) qui comporte quatre pages de données, 1, 2, 3 et 4. Imaginez qu'un clone, B, soit créé à partir du cluster Amazon DocumentDB. Lors de la création du clone, aucune donnée n’est copiée. Le clone pointe plutôt vers le même ensemble de pages que le cluster Amazon DocumentDB source.

Lors de la création du clone, aucun stockage supplémentaire n’est généralement nécessaire. Le protocole de copie sur écriture utilise le même segment sur le support de stockage physique que le segment source. Un stockage supplémentaire n’est requis que si la capacité du segment source n’est pas suffisante pour le segment de clone entier. Dans ce cas, le segment source est copié sur un autre périphérique physique.

Les diagrammes suivants présentent un exemple de protocole de copie sur écriture en action utilisant les cluster A et clone B que ceux montrés précédemment. Supposons que vous apportiez une modification à votre cluster Amazon DocumentDB (A), ce qui entraîne une modification des données contenues sur la page 1. Au lieu d'écrire sur la page 1 d'origine, Amazon DocumentDB crée une nouvelle page 1 [A]. Le volume de cluster Amazon DocumentDB pour le cluster (A) pointe désormais vers les pages 1 [A], 2, 3 et 4, tandis que le clone (B) fait toujours référence aux pages d'origine.

Sur le clone, une modification est apportée à la page 4 sur le volume de stockage. Au lieu d'écrire sur la page 4 d'origine, Amazon DocumentDB crée une nouvelle page, 4 [B]. Le clone pointe maintenant vers les pages 1, 2, 3 et 4[B], tandis que le cluster (A) continue de pointer vers les pages 1[A], 2, 3 et 4.

Au fur et à mesure que de nouvelles modifications se produisent à la fois dans le volume du cluster Amazon DocumentDB source et dans le clone, davantage de stockage est nécessaire pour capturer et stocker les modifications.

Suppression d'un volume de cluster source

Lorsque vous supprimez un volume de cluster source auquel un ou plusieurs clones sont associés, ceux-ci ne sont pas affectés. Les clones continuent de pointer vers les pages qui étaient précédemment la propriété du volume de cluster source.

Création d'un clone Amazon DocumentDB

Vous pouvez créer un clone dans le même AWS compte que le cluster Amazon DocumentDB source. Pour ce faire, vous pouvez utiliser les Console de gestion AWS ou AWS CLI les procédures suivantes.

En utilisant le clonage Amazon DocumentDB, vous pouvez créer un clone de cluster Amazon DocumentDB provisionné à partir d'un cluster Amazon DocumentDB provisionné.

Using the Console de gestion AWS

La procédure suivante décrit comment cloner un cluster Amazon DocumentDB à l'aide du Console de gestion AWS.

Création d'un clone à partir des Console de gestion AWS résultats d'un cluster Amazon DocumentDB avec une instance Amazon DocumentDB.

Ces instructions s'appliquent aux clusters de bases de données appartenant au même AWS compte que celui qui crée le clone. Le cluster de bases de données doit appartenir au même AWS compte car le clonage entre comptes n'est pas pris en charge dans Amazon DocumentDB.

Pour créer un clone d'un cluster de base de données appartenant à votre AWS compte à l'aide du Console de gestion AWS

1. Connectez-vous au et ouvrez Console de gestion AWS la console Amazon DocumentDB à https://console.aws.amazon.com/docdb l'adresse.

2. Dans le panneau de navigation, choisissez Clusters.

3. Choisissez votre cluster Amazon DocumentDB dans la liste et, dans Actions, choisissez Créer un clone.

   

   La page Créer un clone s'ouvre, où vous pouvez configurer un identifiant de cluster et une classe d'instance, ainsi que d'autres options pour le clone de cluster Amazon DocumentDB.

4. Dans la section Settings (Paramètres), procédez comme suit :

   1. Dans Identifiant de cluster, entrez le nom que vous souhaitez donner à votre cluster Amazon DocumentDB cloné.

   2. Pour la configuration de l'instance, sélectionnez une classe d'instance appropriée pour votre cluster Amazon DocumentDB cloné.

      

   3. Pour les paramètres réseau, choisissez un groupe de sous-réseaux pour votre cas d'utilisation et les groupes de sécurité VPC associés.

   4. En Encryption-at-rest effet, si le cryptage est activé sur le cluster source (le cluster qui est cloné), le cryptage doit également être activé sur le cluster cloné. Si ce scénario est vrai, les options Activer le chiffrement sont grisées (désactivées) mais l'option Activer le chiffrement est sélectionnée. À l'inverse, si le chiffrement n'est pas activé sur le cluster source, les options Activer le chiffrement sont disponibles et vous pouvez choisir d'activer ou de désactiver le chiffrement.

      

   5. Terminez la configuration du nouveau clone de cluster en sélectionnant le type de journaux à exporter (facultatif), en saisissant un port spécifique utilisé pour se connecter au cluster et en activant la protection contre la suppression accidentelle du cluster (activée par défaut).

      

   6. Terminez la saisie de tous les paramètres de votre clone de cluster Amazon DocumentDB. Pour en savoir plus sur les paramètres de cluster et d'instance Amazon DocumentDB, consultezGestion des clusters Amazon DocumentDB.

5. Choisissez Créer un clone pour lancer le clone Amazon DocumentDB du cluster Amazon DocumentDB de votre choix.

Lorsque le clone est créé, il est répertorié avec vos autres clusters Amazon DocumentDB dans la section Bases de données de la console et affiche son état actuel. Votre clone est prêt à être utilisé quand son état est Disponible.

Using the AWS CLI

L'utilisation de AWS CLI pour cloner votre cluster Amazon DocumentDB implique quelques étapes.

La restore-db-cluster-to-point-in-time AWS CLI commande que vous utilisez génère un cluster Amazon DocumentDB vide avec 0 instance Amazon DocumentDB. En d'autres termes, la commande restaure uniquement le cluster Amazon DocumentDB, et non les instances de base de données de ce cluster. Vous faites cela séparément une fois le clone disponible. Les deux étapes du processus sont les suivantes :

1. Créez le clone à l'aide de la commande de la CLI restore-db-cluster-to-point-in-time. Les paramètres que vous utilisez avec cette commande contrôlent le type de capacité et d'autres détails du cluster Amazon DocumentDB vide (clone) en cours de création.

2. Créez l'instance Amazon DocumentDB pour le clone en utilisant la commande CLI create-db-instance pour recréer l'instance Amazon DocumentDB dans le cluster Amazon DocumentDB restauré.

Les commandes suivantes supposent que le AWS CLI est configuré avec votre AWS région comme valeur par défaut. Cette approche vous évite de passer le nom de --region dans chaque commande. Pour plus d'informations, consultez Configuration de l' AWS CLI. Vous pouvez également spécifier la --region dans chacune des commandes de la CLI qui suivent.

Rubriques

Création du clone

Les paramètres spécifiques que vous passez à la commande de la CLI restore-db-cluster-to-point-in-time varient. Ce que vous transmettez dépend du type de clone que vous souhaitez créer.

Suivez la procédure suivante pour créer un clone Amazon DocumentDB provisionné à partir d'un cluster Amazon DocumentDB provisionné.

Pour créer un clone du même mode moteur que le cluster Amazon DocumentDB source

• Utilisez la commande de la CLI restore-db-cluster-to-point-in-time et spécifiez les valeurs des paramètres suivants :

  • --db-cluster-identifier – Choisissez un nom explicite pour votre clone. Vous nommez le clone lorsque vous utilisez la commande de la CLI restore-db-cluster-to-point-in-time.

  • --restore-type : utilisez la commande copy-on-write pour créer un clone du cluster de bases de données source. Sans ce paramètre, le cluster Amazon DocumentDB est restore-db-cluster-to-point-in-time restauré au lieu de créer un clone. Par défaut, restore-type c'estfull-copy.

  • --source-db-cluster-identifier— Utilisez le nom du cluster Amazon DocumentDB source que vous souhaitez cloner.

  • --use-latest-restorable-time – Cette valeur pointe vers les données de volume restaurables les plus récentes pour le clone. Ce paramètre est obligatoire carrestore-type copy-on-write, toutefois, vous ne pouvez pas l'utiliser restore-to-time parameter avec.

L'exemple suivant crée un clone nommé my-clone à partir d'un cluster nommé my-source-cluster.

Pour Linux, macOS ou Unix :

aws docdb restore-db-cluster-to-point-in-time \
    --source-db-cluster-identifier my-source-cluster \
    --db-cluster-identifier my-clone \
    --restore-type copy-on-write \
    --use-latest-restorable-time

Pour Windows :

aws docdb restore-db-cluster-to-point-in-time ^
    --source-db-cluster-identifier my-source-cluster ^
    --db-cluster-identifier my-clone ^
    --restore-type copy-on-write ^
    --use-latest-restorable-time

La commande renvoie l'objet JSON contenant les détails du clone. Vérifiez que votre cluster de bases de données cloné est disponible avant d’essayer de créer l’instance de base de données pour votre clone. Pour plus d'informations, consultez la section Vérification de l'état et obtention des informations sur le clone ci-dessous :

Vérification de l'état et obtention des informations sur le clone

Vous pouvez utiliser la commande suivante pour vérifier l'état de votre cluster de base de données vide nouvellement créé.

$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text

Vous pouvez également obtenir le statut et les autres valeurs dont vous avez besoin pour créer l'instance de base de données pour votre clone à l'aide de la AWS CLI requête suivante :

Pour Linux, macOS ou Unix :

aws docdb describe-db-clusters --db-cluster-identifier my-clone \
  --query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'

Pour Windows :

aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
  --query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"

Cette requête retourne une sortie similaire à la suivante.

[
  {
        "Status": "available",
        "Engine": "docdb",
        "EngineVersion": "4.0.0",
    }
]

Création de l'instance Amazon DocumentDB pour votre clone

Appelez la commande de la CLI create-db-instance pour créer l'instance de base de données pour votre clone.

Le --db-instance-class paramètre est utilisé uniquement pour les clusters Amazon DocumentDB provisionnés.

Pour Linux, macOS ou Unix :

aws docdb create-db-instance \
    --db-instance-identifier my-new-db \
    --db-cluster-identifier my-clone \
    --db-instance-class  db.r5.4xlarge \
    --engine docdb

Pour Windows :

aws docdb create-db-instance ^
    --db-instance-identifier my-new-db ^
    --db-cluster-identifier my-clone ^
    --db-instance-class  db.r5.4xlarge ^
    --engine docdb

Paramètres à utiliser pour le clonage

Le tableau suivant récapitule les différents paramètres utilisés pour cloner des restore-db-cluster-to-point-in-time clusters Amazon DocumentDB.

Paramètre	Description
--source-db-cluster-identifier	Utilisez le nom du cluster Amazon DocumentDB source que vous souhaitez cloner.
--db-cluster-identifier	Choisissez un nom explicite pour votre clone. Vous nommez votre clone à l'aide de la commande restore-db-cluster-to-point-in-time. Ensuite, vous passez ce nom à la commande create-db-instance.
—type de restauration	Spécifiez copy-on-write comme --restore-type pour créer un clone du cluster de base de données source plutôt que de restaurer le cluster Amazon DocumentDB source.
--use-latest-restorable-time	Cette valeur pointe vers les données de volume restaurables les plus récentes pour le clone.