Restaurer à un moment précis

Vous pouvez restaurer un cluster à tout moment compris dans la période de conservation des sauvegardes du cluster à l'aide de la touche AWS Management Console ou AWS Command Line Interface (AWS CLI).

Note

Vous ne pouvez pas point-in-time restaurer un cluster 3.6 vers un cluster 4.0, mais vous pouvez migrer d'une version de cluster à une autre. Pour plus d'informations, consultez la section concernant Migration vers Amazon DocumentDB.

Gardez ce qui suit à l'esprit lorsque vous restaurez un cluster à un instant dans le passé.

Le nouveau cluster est créé avec la même configuration que le cluster source, mais il est créé avec le groupe de paramètres par défaut. Pour définir le groupe de paramètres du nouveau cluster selon le groupe de paramètres du cluster source, modifiez le cluster une fois qu'il est disponible. Pour plus d'informations sur la modification d'un cluster, consultez Modification d'un cluster Amazon DocumentDB.

Using the AWS Management Console

Vous pouvez restaurer un cluster dans les point-in-time limites de sa période de conservation des sauvegardes en effectuant les opérations suivantes à l'aide du AWS Management Console.

Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.
Dans le panneau de navigation, choisissez Clusters. Dans la liste des clusters, choisissez le bouton sur la gauche du cluster que vous voulez restaurer.

Astuce
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu () dans le coin supérieur gauche de la page.
Dans le menu Actions, sélectionnez Restore to point in time (Restaurer à un instant dans le passé).
Renseignez la section Restore time (Heure de la restauration), qui spécifie la date et l'heure de la restauration.
1. Date de restauration : choisissez ou entrez une date comprise entre l'heure de restauration la plus ancienne et l'heure de restauration la plus récente.
2. Heure de restauration : choisissez ou entrez l'heure, la minute et les secondes qui s'écoulent entre l'heure de restauration la plus ancienne et l'heure de restauration la plus récente.
Renseignez la section Configuration.
1. Identifiant du cluster : acceptez l'identifiant par défaut ou entrez l'identifiant de votre choix.
  
  Contraintes d'attribution de nom relatives à un cluster :
  - La longueur est de [1 à 63] lettres, chiffres ou traits d'union.
  - Le premier caractère doit être une lettre.
  - Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.
  - Doit être unique pour tous les clusters d'AmazonRDS, Neptune et Amazon DocumentDB Compte AWS par région.
2. Classe d'instance : dans la liste déroulante, choisissez la classe d'instance que vous souhaitez pour les instances du cluster.
3. Nombre d'instances : dans la liste déroulante, choisissez le nombre d'instances que vous souhaitez créer lors de la restauration du cluster.
Pour la configuration du stockage en cluster, choisissez une option de stockage.

Note
La configuration de stockage optimisée pour les E/S d'Amazon DocumentDB n'est disponible que sur la version 5.0 du moteur Amazon DocumentDB.
Facultatif. Pour configurer les paramètres réseau, les options de cluster, et activer les exportations de journaux, choisissez Show advanced settings (Afficher les paramètres avancés), puis renseignez les sections suivantes. Dans le cas contraire, passez à l'étape suivante.
- Network settings (Paramètres réseau)
  1. Cloud privé virtuel (VPC) : dans la liste déroulante, choisissez celui VPC que vous souhaitez utiliser pour ce cluster.
  2. Groupe de sous-réseaux : dans la liste déroulante, choisissez le groupe de sous-réseaux pour ce cluster.
  3. VPCgroupes de sécurité : dans la liste déroulante, choisissez les groupes VPC de sécurité pour ce cluster.
- Options de cluster
  1. Port : acceptez le port par défaut (27017) ou utilisez les flèches haut et bas pour définir le port de communication avec ce cluster.
- Exportations des journaux
  1. Journaux d'audit : sélectionnez cette option pour activer l'exportation des journaux d'audit vers Amazon CloudWatch Logs. Si vous sélectionnez cette option, vous devez activer audit_logs dans le groupe de paramètres personnalisés du cluster. Pour de plus amples informations, veuillez consulter Audit des événements Amazon DocumentDB.
  2. Journaux du profileur : sélectionnez cette option pour activer l'exportation des journaux du profileur d'opérations vers Amazon CloudWatch Logs. Si vous sélectionnez cette option, vous devez également modifier les paramètres suivants dans le groupe de paramètres personnalisés du cluster :
    
    profiler— Réglé surenabled.
    
    profiler_threshold_ms— Définissez une valeur pour [0-INT_MAX] définir le seuil pour les opérations de profilage.
    
    profiler_sampling_rate— Définissez une valeur pour [0.0-1.0] définir le pourcentage d'opérations lentes par rapport au profil.
    
    Pour de plus amples informations, veuillez consulter Profilage des opérations Amazon DocumentDB.
  3. Journaux du profileur — Exportez les journaux du profileur vers Amazon CloudWatch
  4. IAMrôle : dans la liste déroulante, sélectionnez Rôle lié au RDS service.
- Balises
  1. Ajouter une étiquette — Dans le champ Clé, entrez le nom de la balise pour votre cluster. Dans la zone Value (Valeur), entrez la valeur de la balise, si vous le souhaitez. Les balises sont utilisées avec les politiques AWS Identity and Access Management (IAM) pour gérer l'accès aux ressources Amazon DocumentDB et pour contrôler les actions qui peuvent être appliquées aux ressources.
- Deletion protection (Protection contre la suppression)
  1. Activer la protection contre la suppression : protège le cluster contre toute suppression accidentelle. Lorsque cette option est activée, vous ne pouvez pas supprimer le cluster.
Pour restaurer le cluster, choisissez Create cluster (Créer un cluster). Vous pouvez également choisir Cancel (Annuler) pour annuler l'opération.

Using the AWS CLI

Pour restaurer un cluster à un instant dans le passé avec la période de rétention des sauvegardes de l'instantané, utilisez l'opération restore-db-cluster-to-point-in-time avec les paramètres suivants.

--db-cluster-identifier— Obligatoire. Il faut créer le nom du nouveau cluster. Ce cluster ne peut pas exister avant l'opération. La valeur du paramètre doit respecter les contraintes suivantes.

Contraintes d'attribution de nom relatives à un cluster :
- La longueur est de [1 à 63] lettres, chiffres ou traits d'union.
- Le premier caractère doit être une lettre.
- Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.
- Doit être unique pour tous les clusters d'AmazonRDS, Neptune et Amazon DocumentDB Compte AWS par région.
--restore-to-time— UTC Date et heure de restauration du cluster. Par exemple, 2018-06-07T23:45:00Z.

Contraintes de temps :
- Elles doivent se situer avant l'heure de restauration la plus récente pour le cluster.
- Cela doit être indiqué si le paramètre --use-latest-restorable-time n'est pas fourni.
- Cela ne peut pas être spécifié lorsque le paramètre --use-latest-restorable-time est true.
- Cela ne peut pas être spécifié lorsque la valeur du paramètre --restore-type est copy-on-write.
--source-db-cluster-identifier— Nom du cluster source à partir duquel effectuer la restauration. Ce cluster doit exister et être disponible.
--use-latest-restorable-timeou --no-use-latest-restorable-time — S'il faut restaurer à l'heure de sauvegarde restaurable la plus récente. Cela ne doit pas être indiqué si le paramètre --restore-to-time est fourni.
--storage-type standard | iopt1— Facultatif. Par défaut: standard.

L' AWS CLI opération restaure restore-db-cluster-to-point-in-time uniquement le cluster, pas les instances de ce cluster. Vous devez invoquer l'opération create-db-instance pour créer des instances pour le cluster restauré, en spécifiant l'identifiant du cluster restauré dans --db-cluster-identifier. Vous pouvez créer des instances de bases de données uniquement après la fin de l'opération restore-db-cluster-to-point-in-time et lorsque le cluster restauré est disponible.

L'exemple suivant crée sample-cluster-restored à partir de l'instantané sample-cluster-snapshot vers la dernière heure de restauration la plus récente.

Pour Linux, macOS ou Unix :


aws docdb restore-db-cluster-to-point-in-time \
    --db-cluster-identifier sample-cluster-restored \
    --source-db-cluster-identifier sample-cluster-snapshot \
    --use-latest-restorable-time

Pour Windows :


aws docdb restore-db-cluster-to-point-in-time ^
    --db-cluster-identifier sample-cluster-restored ^
    --source-db-cluster-identifier sample-cluster-snapshot ^
    --use-latest-restorable-time

L'exemple suivant crée à sample-cluster-restored partir de l'instantané sample-cluster-snapshot jusqu'à 03:15 le 11 décembre 2018 (UTC), c'est-à-dire pendant la période de conservation des sauvegardes desample-cluster.

Pour Linux, macOS ou Unix :


aws docdb restore-db-cluster-to-point-in-time \
    --db-cluster-identifier sample-cluster-restore \
    --source-db-cluster-identifier sample-cluster \
    --restore-to-time 2020-05-12T03:15:00Z

Pour Windows :


aws docdb restore-db-cluster-to-point-in-time ^
    --db-cluster-identifier sample-cluster-restore ^
    --source-db-cluster-identifier sample-cluster ^
    --restore-to-time 2020-05-12T03:15:00Z

Le résultat de cette opération ressemble à ceci.


{
    "DBCluster": {
        "AvailabilityZones": [
            "us-east-1c",
            "us-west-2b",
            "us-west-2a"
        ],
        "BackupRetentionPeriod": 1,
        "DBClusterIdentifier": "sample-cluster-restored",
        "DBClusterParameterGroup": "sample-parameter-group",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
        "ReaderEndpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
        "MultiAZ": false,
        "Engine": "docdb",
        "EngineVersion": "4.0.0",
        "Port": 27017,
        "MasterUsername": "master-user",
        "PreferredBackupWindow": "02:00-02:30",
        "PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-abc0123",
                "Status": "active"
            }
        ],
        "HostedZoneId": "ABCDEFGHIJKLM",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:<accountID^>:key/sample-key",
        "DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "DBClusterArn": "arn:aws:rds:us-east-1:<accountID>:cluster:sample-cluster-restored",
        "AssociatedRoles": [],
        "ClusterCreateTime": "2020-04-24T20:14:36.713Z",
        "DeletionProtection": false
    }
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Restauration à partir d'un instantané de cluster

Supprimer un instantané de cluster

Restaurer à un moment précis

Note

Astuce

Note