Restauration d'une table à partir d'une sauvegarde (console)Restauration d'une table à partir d'une sauvegarde (AWS CLI)

Restauration d'une table DynamoDB à partir d'une sauvegarde

Cette section explique comment restaurer une table à partir d'une sauvegarde à l'aide de la console Amazon DynamoDB ou de l'AWS Command Line Interface (AWS CLI).

Note

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

Rubriques

Restauration d'une table à partir d'une sauvegarde (console)
Restauration d'une table à partir d'une sauvegarde (AWS CLI)

Restauration d'une table à partir d'une sauvegarde (console)

La procédure suivante décrit comment restaurer la table Music à l'aide du fichier MusicBackup créé dans le didacticiel Sauvegarde d'une table DynamoDB.

Note

Cette procédure suppose que la table Music n'existe plus avant de la restaurer à l'aide du fichier MusicBackup.

Pour restaurer une table à partir d'une sauvegarde

Connectez-vous à l'AWS Management Console et ouvrez la console DynamoDB à l'adresse https://console.aws.amazon.com/dynamodb/.
Dans le volet de navigation sur le côté gauche de la console, choisissez Sauvegardes.
Dans la liste des sauvegardes, choisissez MusicBackup.
Choisissez Restore (Restaurer).
Entrez Music comme nom de la nouvelle table. Confirmez le nom de la sauvegarde et les autres détails de la sauvegarde. Choisissez ensuite Restore table pour démarrer le processus de restauration.

Note
Vous pouvez restaurer la table dans la même région AWS que la sauvegarde ou dans une région différente. Vous pouvez également exclure la création d'index secondaires sur la nouvelle table restaurée. En outre, vous pouvez spécifier un mode de chiffrement différent.
Les tables restaurées à partir de sauvegardes sont toujours créées à l'aide de la classe de tables DynamoDB Standard.

La table en cours de restauration s'affiche avec le statut Creating. Une fois le processus de restauration terminé, l'état de la table Music devient Active.

Restauration d'une table à partir d'une sauvegarde (AWS CLI)

Procédez comme suit pour utiliser l'AWS CLI afin de restaurer la table Music à l'aide du fichier MusicBackup créé dans le didacticiel Sauvegarde d'une table DynamoDB.

Pour restaurer une table à partir d'une sauvegarde

Confirmez la sauvegarde à restaurer à l'aide de la commande list-backups. Cet exemple utilise MusicBackup.
```
aws dynamodb list-backups
```
Pour obtenir des détails supplémentaires pour la sauvegarde, utilisez la commande describe-backup. Vous pouvez accéder à l'entrée backup-arn issue de l'étape précédente.
```
aws dynamodb describe-backup \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01489173575360-b308cd7d 
```

Restaurez la table à partir de la sauvegarde. Dans ce cas, MusicBackup restaure la table Music dans la même région AWS.


aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01489173575360-b308cd7d

Restaurez la table à partir de la sauvegarde avec des paramètres de table personnalisés. Dans ce cas, MusicBackup restaure la table Music et spécifie un mode de chiffrement pour la table restaurée.

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, consultez Gestion des tables chiffrées dans DynamoDB.
```
aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01581080476474-e177ebe2 \
--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 sauvegarde.
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.
- 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-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01581080476474-e177ebe2 \
--sse-specification-override Enabled=true,SSEType=KMS
```
Vous pouvez remplacer le mode de facturation et le débit alloué pour la table restaurée.
```
aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01489173575360-b308cd7d \
--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 table restaurée.
```
aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01581081403719-db9c1f91 \
--global-secondary-index-override '[]' \
--sse-specification-override Enabled=true,SSEType=KMS
```
Note
Les index secondaires fournis doivent correspondre aux index existants. Vous ne pouvez pas créer de nouveaux index au moment de la restauration.

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-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:eu-west-1:123456789012:table/Music/backup/01581082594992-303b6239 \
--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=5,WriteCapacityUnits=5}" \
--sse-specification-override Enabled=true,SSEType=KMS
```

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


aws dynamodb describe-table --table-name Music

La table en cours de restauration à partir de la sauvegarde s'affiche avec le statut Creating. Une fois le processus de restauration terminé, l'état de la table Music devient Active.

Important

Ne modifiez ou ne supprimez pas votre politique de rôle IAM quand une restauration est en cours, car cela pourrait entraîner 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 RestoreTableFromBackup sous-jacente ne pourra pas écrire les données restaurées dans la table.

Une fois l'opération de restauration terminée, vous pouvez modifier ou supprimer votre politique de rôle IAM.

Les politiques IAM impliquant des restrictions d'adresses IP sources pour accéder à la table de restauration cible doivent avoir la clé aws:ViaAWSService définie sur false pour s'assurer que les restrictions s'appliquent uniquement aux demandes faites directement par un principal. Sinon, la restauration est annulée.

Si votre sauvegarde est chiffrée avec une Clé gérée par AWS ou une clé gérée par le client, ne désactivez pas ou ne supprimez pas la clé en cours de restauration, car cela entraîne un échec de la restauration.

Une fois l'opération de restauration terminée, vous pouvez modifier la clé de chiffrement de la table restaurée et désactiver ou supprimer l'ancienne clé.

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

Sauvegarde d'une table

Suppression d'une sauvegarde de table