Restauration d’une table DynamoDB à un instant dans le passé - Amazon DynamoDB
Restauration d’une table DynamoDB à un instant dans le passé (console)Restauration d’une table à un instant dans le passé (AWS CLI)

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.

Restauration d’une table DynamoDB à un instant dans le passé

La restauration à un instant dans le passé d’Amazon DynamoDB fournit des sauvegardes continues des données de votre table DynamoDB. Vous pouvez restaurer une table à un instant dans le passé à l’aide de la console AWS Command Line Interface ou de l’AWS CLI (). Le processus de restauration à un instant dans le passé restaure une nouvelle table.

Si vous souhaitez utiliser l’AWS CLI, vous devez d’abord la configurer. Pour plus d’informations, consultez Accès à DynamoDB.

Restauration d’une table DynamoDB à un instant dans le passé (console)

L’exemple suivant montre comment utiliser la console DynamoDB pour restaurer une table existante nommée Music à un instant dans le passé.

Note

Cette procédure suppose que vous ayez activé la restauration à un instant dans le passé. Pour l’activer pour la table Music, dans l’onglet Sauvegardes, dans la section Reprise ponctuelle (PITR), choisissez Modifier puis cochez la case à côté de Activer la restauration à un instant dans le passé.

Pour restaurer une table à un instant dans le passé

  1. Connectez-vous à l’AWS Management Console et ouvrez la console DynamoDB à l’adresse https://console.aws.amazon.com/dynamodb/.

  2. Dans le volet de navigation sur le côté gauche de la console, choisissez Tables.

  3. Dans la liste des tables, choisissez la table Music.

  4. Dans l’onglet Sauvegardes de la table Music, dans la section Récupération à un instant donné dans le passé (PITR), choisissez Restaurer.

  5. Pour le nom de la nouvelle table, tapez MusicMinutesAgo.

    Note

    Vous pouvez restaurer la table dans la même région AWS que la table source ou dans une région différente. Vous pouvez également exclure la création d’index secondaires sur la table restaurée. En outre, vous pouvez spécifier un mode de chiffrement différent.

  6. Pour confirmer l’heure de restauration, définissez la date et l’heure de restauration sur Plus tôt. Choisissez ensuite Restaurer pour démarrer le processus de restauration.

    La table en cours de restauration s’affiche avec le statut Restauration en cours. Une fois le processus de restauration terminé, l’état de la table MusicMinutesAgo devient Active.

Restauration d’une table à un instant dans le passé (AWS CLI)

La procédure suivante montre comment utiliser l’AWS CLI pour restaurer une table existante nommée Music à un instant dans le passé.

Note

Cette procédure suppose que vous ayez activé la restauration à un instant dans le passé. Pour l’activer pour la table Music, exécutez la commande suivante.

aws dynamodb update-continuous-backups \
    --table-name Music \
    --point-in-time-recovery-specification PointInTimeRecoveryEnabled=True

Pour restaurer une table à un instant dans le passé

  1. Confirmez l’activation de la restauration à un instant dans le passé pour la table Music à l’aide de la commande describe-continuous-backups.

    aws dynamodb describe-continuous-backups \
    --table-name Music

    Les sauvegardes continues (automatiquement activées lors de la création de la table) et la restauration à un instant dans le passé sont activées.

    {
    "ContinuousBackupsDescription": {
        "PointInTimeRecoveryDescription": {
            "PointInTimeRecoveryStatus": "ENABLED", 
            "EarliestRestorableDateTime": 1519257118.0, 
            "LatestRestorableDateTime": 1520018653.01
        }, 
        "ContinuousBackupsStatus": "ENABLED"
    }
}

  2. Restaurez la table à un instant dans le passé. Dans ce cas, la table Music est restaurée à LatestRestorableDateTime (il y a environ 5 minutes) dans la même région AWS.

    aws dynamodb restore-table-to-point-in-time \
    --source-table-name Music \
    --target-table-name MusicMinutesAgo \
    --use-latest-restorable-time
    Note

    Vous pouvez également restaurer à un instant spécifique dans le passé. Pour ce faire, exécutez la commande à l’aide de l’argument --restore-date-time et spécifiez un horodatage. Vous pouvez spécifier n’importe quel instant spécifique au cours de la période de restauration configurée, qui peut être définie sur une valeur comprise entre 1 et 35 jours. Par exemple, la commande suivante restaure la table à la EarliestRestorableDateTime.

    aws dynamodb restore-table-to-point-in-time \
    --source-table-name Music \
    --target-table-name MusicEarliestRestorableDateTime \
    --no-use-latest-restorable-time \
    --restore-date-time 1519257118.0

    La spécification de l’argument --no-use-latest-restorable-time est facultative lors de la restauration à un instant spécifique dans le passé.

  3. Restaurez la table à un instant dans le passé avec des paramètres de table personnalisés. Dans ce cas, la table Music est restaurée à la LatestRestorableDateTime (il y a environ 5 minutes).

    Vous pouvez spécifier un mode de chiffrement différent pour la table restaurée, comme suit.

    Note

    Le paramètre sse-specification-override prend les mêmes valeurs que le paramètre sse-specification-override utilisé dans la commande CreateTable. Pour en savoir plus, veuillez consulter la section Gestion des tables chiffrées dans DynamoDB.

    aws dynamodb restore-table-to-point-in-time \
    --source-table-name Music \
    --target-table-name MusicMinutesAgo \
    --use-latest-restorable-time \
    --sse-specification-override Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234

    Vous pouvez restaurer la table dans une région AWS différente de celle où réside la table source.

    Note

    • Le paramètre sse-specification-override est obligatoire pour les restaurations entre régions, mais facultatif pour les restaurations dans la même région que celle de la table source.

    • Le paramètre source-table-arn doit être fourni pour les restaurations entre régions.

    • Lorsque vous effectuez une restauration entre régions à partir de la ligne de commande, vous devez définir la région AWS par défaut sur la région de destination souhaitée. Pour en savoir plus, consultez Options de ligne de commande dans le Guide de l’utilisateur AWS Command Line Interface.

    aws dynamodb restore-table-to-point-in-time \
    --source-table-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music \
    --target-table-name MusicMinutesAgo \
    --use-latest-restorable-time \
    --sse-specification-override Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234

    Vous pouvez remplacer le mode de facturation et le débit alloué pour la table restaurée.

    aws dynamodb restore-table-to-point-in-time \
    --source-table-name Music \
    --target-table-name MusicMinutesAgo \
    --use-latest-restorable-time \
    --billing-mode-override PAY_PER_REQUEST

    Vous pouvez exclure la création d’index secondaires sur la table restaurée.

    Note

    Les restaurations peuvent être plus rapides et plus économiques si vous empêchez la création de certains index ou de tous les index secondaires sur la nouvelle table restaurée.

    aws dynamodb restore-table-to-point-in-time \
    --source-table-name Music \
    --target-table-name MusicMinutesAgo \
    --use-latest-restorable-time \
    --global-secondary-index-override '[]'

    Vous pouvez utiliser une combinaison de remplacements différents. Par exemple, vous pouvez utiliser un index secondaire global unique et modifier le débit alloué en même temps, comme suit.

    aws dynamodb restore-table-to-point-in-time \
    --source-table-name Music \
    --target-table-name MusicMinutesAgo \
    --billing-mode-override PROVISIONED \
    --provisioned-throughput-override ReadCapacityUnits=100,WriteCapacityUnits=100 \
    --global-secondary-index-override IndexName=singers-index,KeySchema=["{AttributeName=SingerName,KeyType=HASH}"],Projection="{ProjectionType=KEYS_ONLY}",ProvisionedThroughput="{ReadCapacityUnits=50,WriteCapacityUnits=50}" \
    --sse-specification-override Enabled=true,SSEType=KMS \
    --use-latest-restorable-time

Afin de vérifier la restauration, utilisez la commande describe-table pour décrire la table MusicEarliestRestorableDateTime.

aws dynamodb describe-table --table-name MusicEarliestRestorableDateTime

La table en cours de restauration est affichée avec le statut Création en cours et la restauration en cours avec la valeur vrai. Une fois le processus de restauration terminé, l’état de la table MusicEarliestRestorableDateTime devient Active.

Important

Pendant la restauration, ne modifiez ou ne supprimez pas les politiques AWS Identity and Access Management (IAM) qui accordent à l’entité (par exemple, utilisateur, groupe ou rôle) l’autorisation d’effectuer une restauration. Sinon, il peut en résulter un comportement inattendu. Par exemple, supposons que vous ayez supprimé les autorisations d’écriture pour une table en cours de restauration. Dans ce cas, l’opération RestoreTableToPointInTime sous-jacente ne peut pas écrire les données restaurées dans la table. Les politiques IAM impliquant des restrictions d’adresses IP sources pour l’accès à la table de restauration cible peuvent également occasionner des problèmes.

Vous pouvez modifier ou supprimer des autorisations uniquement lorsque l’opération de restauration est terminée.