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.
# Backup et restauration des données avec point-in-time restauration pour Amazon Keyspaces
Point-in-time La restauration (PITR) permet de protéger vos tables Amazon Keyspaces contre les opérations d'écriture ou de suppression accidentelles en vous fournissant des sauvegardes continues des données de vos tables.
Supposons, par exemple, qu'un script de test écrit accidentellement dans une table Amazon Keyspaces de production. Grâce à point-in-time la restauration, vous pouvez restaurer les données de cette table à tout moment depuis que le PITR a été activé au cours des 35 derniers jours. Si vous supprimez une table alors que la point-in-time restauration est activée, vous pouvez rechercher les données de la table supprimée pendant 35 jours (sans frais supplémentaires) et les restaurer dans l'état dans lequel elles se trouvaient juste avant le point de suppression.
Vous pouvez restaurer une table Amazon Keyspaces à un moment précis en utilisant la console, le AWS SDK et le () ou Cassandra Query Language AWS Command Line Interface (CQL AWS CLI). Pour de plus amples informations, veuillez consulter [Utiliser point-in-time la restauration dans Amazon Keyspaces](PointInTimeRecovery_Tutorial.md).
Point-in-time les opérations n'ont aucun impact sur les performances ou la disponibilité de la table de base, et la restauration d'une table ne consomme pas de débit supplémentaire.
Pour plus d'informations sur les quotas PITR, consultez[Quotas pour Amazon Keyspaces (pour Apache Cassandra)](quotas.md).
Pour plus d'informations sur les tarifs, consultez les tarifs d'[Amazon Keyspaces (pour Apache Cassandra](https://aws.amazon.com/keyspaces/pricing)).
**Topics**
+ [Comment fonctionne point-in-time la restauration dans Amazon Keyspaces](PointInTimeRecovery_HowItWorks.md)
+ [Utiliser point-in-time la restauration dans Amazon Keyspaces](PointInTimeRecovery_Tutorial.md)
# Comment fonctionne point-in-time la restauration dans Amazon Keyspaces
Cette section fournit un aperçu du fonctionnement de Amazon Keyspaces point-in-time Recovery (PITR). Pour plus d'informations sur les tarifs, consultez les tarifs [d'Amazon Keyspaces (pour Apache Cassandra](https://aws.amazon.com/keyspaces/pricing)).
**Topics**
+ [Fenêtre temporelle pour les sauvegardes continues PITR](#howitworks_backup_window)
+ [Paramètres de restauration PITR](#howitworks_backup_settings)
+ [Restauration PITR de tables chiffrées](#howitworks_backup_encryption)
+ [Restauration PITR de tables multirégionales](#howitworks_backup_multiRegion)
+ [Restauration PITR de tables avec des types définis par l'utilisateur () UDTs](#howitworks_backup_udt)
+ [Durée de restauration des tables avec PITR](#howitworks_restore_time)
+ [Amazon Keyspaces PITR et intégration aux services AWS](#howitworks_integration)
## Fenêtre temporelle pour les sauvegardes continues PITR
Amazon Keyspaces PITR utilise deux horodatages pour maintenir la période pendant laquelle les sauvegardes restaurables sont disponibles pour une table.
+ Heure de restauration la plus ancienne : indique l'heure de la première sauvegarde restaurable. La première sauvegarde restaurable remonte à 35 jours ou à la date d'activation du PITR, selon la date la plus récente. La période de sauvegarde maximale de 35 jours ne peut pas être modifiée.
+ Heure actuelle — L'horodatage de la dernière sauvegarde restaurable est l'heure actuelle. Si aucun horodatage n'est fourni lors d'une restauration, l'heure actuelle est utilisée.
Lorsque le PITR est activé, vous pouvez effectuer une restauration à n'importe quel moment entre `EarliestRestorableDateTime` et`CurrentTime`. Vous ne pouvez restaurer les données d'une table qu'à une date où le PITR était activé.
Si vous désactivez le PITR puis le réactivez ultérieurement, vous redéfinissez l'heure de début de la première sauvegarde disponible à la date de réactivation du PITR. Cela signifie que la désactivation du PITR efface l'historique de vos sauvegardes.
**Note**
Les opérations du langage de définition des données (DDL) sur les tables, telles que les modifications de schéma, sont effectuées de manière asynchrone. Vous ne pouvez voir que les opérations terminées dans les données de votre table restaurée, mais vous pouvez voir des actions supplémentaires sur votre table source si elles étaient en cours au moment de la restauration. Pour obtenir la liste des instructions DDL, consultez[Instructions DDL (langage de définition des données) dans Amazon Keyspaces](cql.ddl.md).
Il n'est pas nécessaire qu'une table soit active pour être restaurée. Vous pouvez également restaurer les tables supprimées si le PITR a été activé sur la table supprimée et si la suppression a eu lieu dans la fenêtre de sauvegarde (ou au cours des 35 derniers jours).
**Note**
Si une nouvelle table est créée avec le même nom qualifié (par exemple, mykeyspace.mytable) qu'une table précédemment supprimée, la table supprimée ne pourra plus être restaurée. Si vous essayez de le faire depuis la console, un avertissement s'affiche.
## Paramètres de restauration PITR
Lorsque vous restaurez une table à l'aide de PITR, Amazon Keyspaces restaure le schéma et les données de votre table source dans l'état basé sur l'horodatage `day:hour:minute:second` () sélectionné pour une nouvelle table. PITR ne remplace pas les tables existantes.
Outre le schéma et les données de la table, PITR les restaure `custom_properties` à partir de la table source. Contrairement aux données de la table, qui sont restaurées en fonction de l'horodatage sélectionné entre l'heure de restauration la plus ancienne et l'heure actuelle, les propriétés personnalisées sont toujours restaurées en fonction des paramètres de la table à l'heure actuelle.
Les paramètres de la table restaurée correspondent aux paramètres de la table source avec l'horodatage du lancement de la restauration. Si vous souhaitez remplacer ces paramètres lors de la restauration, vous pouvez le faire à l'aide `WITH custom_properties` de. Les propriétés personnalisées incluent les paramètres suivants.
+ Mode de capacité en lecture/écriture
+ Paramètres de capacité de débit provisionnée
+ Réglages PITR
Si la table est en mode capacité allouée avec le dimensionnement automatique activé, l'opération de restauration rétablit également les paramètres de dimensionnement automatique de la table. Vous pouvez les remplacer à l'aide du `autoscaling_settings` paramètre dans CQL ou à l'`autoScalingSpecification`aide de la CLI. Pour plus d'informations sur les paramètres de mise à l'échelle automatique, consultez[Gérez automatiquement la capacité de débit grâce au dimensionnement automatique d'Amazon Keyspaces](autoscaling.md).
Lorsque vous effectuez une restauration complète de la table, tous les paramètres de la table restaurée proviennent des paramètres actuels de la table source au moment de la restauration.
Supposons par exemple que le débit alloué d’une table vienne d’être abaissé à 50 unités de capacité de lecture et 50 unités de capacité d’écriture. Vous rétablissez ensuite l'état de la table à il y a trois semaines. À cette époque, son débit provisionné était fixé à 100 unités de capacité de lecture et à 100 unités de capacité d'écriture. Dans ce cas, Amazon Keyspaces restaure les données de votre table à ce moment-là, mais utilise les paramètres de débit actuels (50 unités de capacité de lecture et 50 unités de capacité d'écriture).
Les paramètres suivants ne sont pas restaurés et vous devez les configurer manuellement pour la nouvelle table.
+ Flux de capture des données de modification (CDC) d'Amazon Keyspaces
+ Gestion des identités et des accès AWS politiques (IAM)
+ CloudWatch Mesures et alarmes Amazon
+ Tags (peuvent être ajoutés à l'`RESTORE`instruction CQL en utilisant`WITH TAGS`)
## Restauration PITR de tables chiffrées
Lorsque vous restaurez une table à l'aide du PITR, Amazon Keyspaces restaure les paramètres de chiffrement de votre table source. Si la table a été chiffrée avec un Clé détenue par AWS (par défaut), elle est automatiquement restaurée avec le même paramètre. Si la table que vous souhaitez restaurer a été chiffrée à l'aide d'une clé gérée par le client, la même clé gérée par le client doit être accessible à Amazon Keyspaces pour restaurer les données de la table.
Vous pouvez modifier les paramètres de chiffrement de la table au moment de la restauration. Pour passer d'une clé gérée par le client Clé détenue par AWS à une clé gérée par le client, vous devez fournir une clé gérée par le client valide et accessible au moment de la restauration.
Si vous souhaitez passer d'une clé gérée par le client à une Clé détenue par AWS, vérifiez qu'Amazon Keyspaces a accès à la clé gérée par le client de la table source pour restaurer la table avec un. Clé détenue par AWS Pour plus d'informations sur les paramètres de chiffrement au repos des tables, consultez[Chiffrement au repos : comment cela fonctionne dans Amazon Keyspaces](encryption.howitworks.md).
**Note**
Si le tableau a été supprimé parce qu'Amazon Keyspaces a perdu l'accès à votre clé gérée par le client, vous devez vous assurer que la clé gérée par le client est accessible à Amazon Keyspaces avant d'essayer de restaurer le tableau. Une table chiffrée à l'aide d'une clé gérée par le client ne peut pas être restaurée si Amazon Keyspaces n'a pas accès à cette clé. Pour plus d'informations, consultez la section [Résolution des problèmes d'accès aux clés](https://docs.aws.amazon.com/kms/latest/developerguide/policy-evaluation.html) dans le Guide du AWS Key Management Service développeur.
## Restauration PITR de tables multirégionales
Vous pouvez restaurer une table multirégionale à l'aide de PITR. Pour que l'opération de restauration soit réussie, le PITR doit être activé sur toutes les répliques de la table source et la table source et la table de destination doivent être répliquées sur la même table. Régions AWS
Amazon Keyspaces rétablit les paramètres de la table source dans chacune des régions répliquées faisant partie de l'espace de touches. Vous pouvez également modifier les paramètres lors de l'opération de restauration. Pour plus d'informations sur les paramètres qui peuvent être modifiés au cours de la restauration, consultez[Paramètres de restauration PITR](#howitworks_backup_settings).
Pour plus d'informations sur la réplication multirégionale, consultez[Comment fonctionne la réplication multirégionale dans Amazon Keyspaces](multiRegion-replication_how-it-works.md).
## Restauration PITR de tables avec des types définis par l'utilisateur () UDTs
Vous pouvez restaurer une table qui utilise UDTs. Pour que l'opération de restauration soit réussie, les références UDTs doivent exister et être valides dans le keyspace.
Si un UDT requis est absent lorsque vous tentez de restaurer une table, Amazon Keyspaces essaie de restaurer automatiquement le schéma UDT, puis continue de restaurer la table.
Si vous avez supprimé et recréé l'UDT, Amazon Keyspaces restaure l'UDT avec le nouveau schéma de l'UDT et rejette la demande de restauration de la table à l'aide du schéma UDT d'origine. Dans ce cas, si vous souhaitez restaurer la table avec l'ancien schéma UDT, vous pouvez restaurer la table dans un nouvel espace de touches. Lorsque vous supprimez et recréez un UDT, même si le schéma de l'UDT recréé est identique à celui de l'UDT supprimé, l'UDT recréé est considéré comme un nouvel UDT. Dans ce cas, Amazon Keyspaces rejette la demande de restauration de la table avec l'ancien schéma UDT.
Si l'UDT est absent et qu'Amazon Keyspaces tente de le restaurer, la tentative échoue si vous avez atteint le nombre maximum UDTs de comptes pour le compte dans la région.
Pour plus d'informations sur les quotas UDT et les valeurs par défaut, consultez[Quotas et valeurs par défaut pour les types définis par l'utilisateur (UDTs) dans Amazon Keyspaces](quotas.md#quotas-udts). Pour plus d'informations sur l'utilisation UDTs, consultez[Types définis par l'utilisateur (UDTs) dans Amazon Keyspaces](udts.md).
## Durée de restauration des tables avec PITR
Le temps nécessaire pour restaurer une table dépend de plusieurs facteurs et n'est pas toujours directement corrélé à la taille de la table.
Voici quelques points à prendre en compte concernant les délais de restauration.
+ Vous restaurez vos sauvegardes vers une nouvelle table. Même si la table est vide, la réalisation de toutes les actions nécessaires à la création de la nouvelle table et au lancement du processus de restauration peut prendre jusqu'à 20 minutes.
+ Les temps de restauration des grandes tables dotées de modèles de données bien distribués peuvent être de plusieurs heures, voire plus.
+ Si votre table source contient des données très asymétriques, le délai de restauration peut augmenter. Par exemple, si la clé primaire de votre table utilise le mois de l'année comme clé de partition et que toutes vos données datent du mois de décembre, vous avez des données asymétriques.
Une bonne pratique de planification de la reprise après sinistre consiste à documenter régulièrement les temps moyens de restauration et à déterminer comment ces délais affectent votre objectif global de temps de récupération.
## Amazon Keyspaces PITR et intégration aux services AWS
Les opérations PITR suivantes sont enregistrées AWS CloudTrail pour permettre une surveillance et un audit continus.
+ Créez une nouvelle table avec PITR activé ou désactivé.
+ Activez ou désactivez le PITR sur une table existante.
+ Restaurez une table active ou supprimée.
Pour de plus amples informations, veuillez consulter [Journalisation des appels d'API Amazon Keyspaces avec AWS CloudTrail](logging-using-cloudtrail.md).
Vous pouvez effectuer les actions PITR suivantes à l'aide CloudFormation de.
+ Créez une nouvelle table avec PITR activé ou désactivé.
+ Activez ou désactivez le PITR sur une table existante.
Pour de plus amples informations, veuillez consulter le document [Référence du type de ressource Cassandra](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Cassandra.html) dans le [Guide de l'utilisateur CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/).
# Utiliser point-in-time la restauration dans Amazon Keyspaces
Avec Amazon Keyspaces (pour Apache Cassandra), vous pouvez restaurer des tables à un moment précis à l'aide de Point-in-Time Restore (PITR). Le PITR vous permet de restaurer un état antérieur d'une table au cours des 35 derniers jours, en fournissant des fonctionnalités de protection et de restauration des données. Cette fonctionnalité est utile dans des cas tels que la suppression accidentelle de données, les erreurs d'application ou à des fins de test. Vous pouvez récupérer les données rapidement et efficacement, en minimisant les temps d'arrêt et les pertes de données. Les sections suivantes vous guident tout au long du processus de restauration des tables à l'aide du PITR dans Amazon Keyspaces, afin de garantir l'intégrité des données et la continuité des activités.
**Topics**
+ [Configurer les autorisations IAM de la table de restauration pour Amazon Keyspaces PITR](howitworks_restore_permissions.md)
+ [Configurer le PITR pour une table dans Amazon Keyspaces](configure_PITR.md)
+ [Désactiver le PITR pour une table Amazon Keyspaces](disable_PITR.md)
+ [Restaurer une table à partir d'une sauvegarde à un moment précis dans Amazon Keyspaces](restoretabletopointintime.md)
+ [Restaurer une table supprimée à l'aide d'Amazon Keyspaces PITR](restoredeleted.md)
# Configurer les autorisations IAM de la table de restauration pour Amazon Keyspaces PITR
Cette section explique comment configurer les autorisations permettant à un principal Gestion des identités et des accès AWS (IAM) de restaurer les tables Amazon Keyspaces. Dans IAM, la politique AWS gérée `AmazonKeyspacesFullAccess` inclut les autorisations de restauration des tables Amazon Keyspaces. Pour mettre en œuvre une politique personnalisée avec les autorisations minimales requises, tenez compte des exigences décrites dans la section suivante.
Pour restaurer correctement une table, le principal IAM a besoin des autorisations minimales suivantes :
+ `cassandra:Restore`— L'action de restauration est requise pour que la table cible soit restaurée.
+ `cassandra:Select`— L'action de sélection est requise pour lire dans la table source.
+ `cassandra:TagResource`— L'action de balise est facultative et n'est requise que si l'opération de restauration ajoute des balises.
Il s'agit d'un exemple de politique qui accorde les autorisations minimales requises à un utilisateur pour restaurer des tables dans Keyspace`mykeyspace`.
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"cassandra:Restore",
"cassandra:Select"
],
"Resource":[
"arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/*",
"arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
]
}
]
}
```
Des autorisations supplémentaires pour restaurer une table peuvent être requises en fonction d'autres fonctionnalités sélectionnées. Par exemple, si la table source est chiffrée au repos à l'aide d'une clé gérée par le client, Amazon Keyspaces doit être autorisé à accéder à la clé gérée par le client de la table source pour pouvoir restaurer correctement la table. Pour de plus amples informations, veuillez consulter [Restauration PITR de tables chiffrées](PointInTimeRecovery_HowItWorks.md#howitworks_backup_encryption).
Si vous utilisez des politiques IAM avec des [clés de condition](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) pour restreindre le trafic entrant vers des sources spécifiques, vous devez vous assurer qu'Amazon Keyspaces est autorisé à effectuer une opération de restauration pour le compte de votre principal. Vous devez ajouter une clé de `aws:ViaAWSService` condition à votre politique IAM si celle-ci limite le trafic entrant à l'une des conditions suivantes :
+ Points de terminaison VPC avec `aws:SourceVpce`
+ plages d'adresses IP avec `aws:SourceIp`
+ VPCs avec `aws:SourceVpc`
La clé de `aws:ViaAWSService` condition autorise l'accès lorsqu'un AWS service fait une demande en utilisant les informations d'identification du principal. Pour plus d'informations, voir [Éléments de politique IAM JSON : clé de condition](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) dans le guide de l'*utilisateur IAM*.
Voici un exemple de politique qui limite le trafic source à une adresse IP spécifique et permet à Amazon Keyspaces de restaurer une table pour le compte du principal.
```
{
"Version":"2012-10-17",
"Statement":[
{
"Sid":"CassandraAccessForCustomIp",
"Effect":"Allow",
"Action":"cassandra:*",
"Resource":"*",
"Condition":{
"Bool":{
"aws:ViaAWSService":"false"
},
"ForAnyValue:IpAddress":{
"aws:SourceIp":[
"123.45.167.89"
]
}
}
},
{
"Sid":"CassandraAccessForAwsService",
"Effect":"Allow",
"Action":"cassandra:*",
"Resource":"*",
"Condition":{
"Bool":{
"aws:ViaAWSService":"true"
}
}
}
]
}
```
Pour un exemple de politique utilisant la clé de condition `aws:ViaAWSService` globale, voir[Politiques relatives aux terminaux VPC et restauration d'Amazon Keyspaces point-in-time (PITR)](vpc-endpoints.md#VPC_PITR_restore).
# Configurer le PITR pour une table dans Amazon Keyspaces
Vous pouvez configurer une table dans Amazon Keyspaces pour les opérations de sauvegarde et de restauration à l'aide de PITR avec la console, le CQL et le. AWS CLI
Lorsque vous créez une nouvelle table à l'aide de CQL ou du AWS CLI, vous devez activer explicitement le PITR dans l'instruction create table. Lorsque vous créez une nouvelle table à l'aide de la console, PITR est activé par défaut.
Pour savoir comment restaurer une table, consultez[Restaurer une table à partir d'une sauvegarde à un moment précis dans Amazon Keyspaces](restoretabletopointintime.md).
------
#### [ Console ]
**Configurer le PITR pour une table à l'aide de la console**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation, choisissez **Tables** et sélectionnez la table que vous souhaitez modifier.
1. Dans l'onglet **Sauvegardes**, choisissez **Modifier**.
1. Dans la section **Modifier les paramètres de point-in-time restauration**, sélectionnez **Activer Point-in-time la restauration**.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Cassandra Query Language (CQL) ]
**Configurer le PITR pour une table à l'aide de CQL**
1. Vous pouvez gérer les paramètres PITR des tables à l'aide de la propriété `point_in_time_recovery` personnalisée.
Pour activer le PITR lorsque vous créez une nouvelle table, vous devez définir le statut de `point_in_time_recovery` à`enabled`. Vous pouvez utiliser la commande CQL suivante à titre d'exemple.
```
CREATE TABLE "my_keyspace1"."my_table1"(
"id" int,
"name" ascii,
"date" timestamp,
PRIMARY KEY("id"))
WITH CUSTOM_PROPERTIES = {
'capacity_mode':{'throughput_mode':'PAY_PER_REQUEST'},
'point_in_time_recovery':{'status':'enabled'}
}
```
**Note**
Si aucune propriété personnalisée de point-in-time restauration n'est spécifiée, point-in-time la restauration est désactivée par défaut.
1. Pour activer le PITR pour une table existante à l'aide de CQL, exécutez la commande CQL suivante.
```
ALTER TABLE mykeyspace.mytable
WITH custom_properties = {'point_in_time_recovery': {'status': 'enabled'}}
```
------
#### [ CLI ]
**Configurez le PITR pour une table à l'aide du AWS CLI**
1. Vous pouvez gérer les paramètres PITR des tables à l'aide de l'`UpdateTable`API.
Pour activer le PITR lorsque vous créez une nouvelle table, vous devez l'inclure `point-in-time-recovery 'status=ENABLED'` dans la commande create table. Vous pouvez utiliser la AWS CLI commande suivante à titre d'exemple. La commande a été divisée en lignes distinctes pour améliorer la lisibilité.
```
aws keyspaces create-table --keyspace-name 'myKeyspace' --table-name 'myTable'
--schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]'
--point-in-time-recovery 'status=ENABLED'
```
**Note**
Si aucune valeur point-in-time de restauration n'est spécifiée, point-in-time la restauration est désactivée par défaut.
1. Pour confirmer le paramètre de point-in-time restauration d'une table, vous pouvez utiliser la AWS CLI commande suivante.
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
1. Pour activer le PITR pour une table existante à l'aide de AWS CLI, exécutez la commande suivante.
```
aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --point-in-time-recovery 'status=ENABLED'
```
------
# Désactiver le PITR pour une table Amazon Keyspaces
Vous pouvez désactiver le PITR pour une table Amazon Keyspaces à tout moment à l'aide de la console, du CQL ou du. AWS CLI
**Important**
La désactivation du PITR supprime immédiatement l'historique de vos sauvegardes, même si vous réactivez le PITR sur la table dans les 35 jours.
Pour savoir comment restaurer une table, consultez[Restaurer une table à partir d'une sauvegarde à un moment précis dans Amazon Keyspaces](restoretabletopointintime.md).
------
#### [ Console ]
**Désactiver le PITR pour une table à l'aide de la console**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation, choisissez **Tables** et sélectionnez la table que vous souhaitez modifier.
1. Dans l'onglet **Sauvegardes**, choisissez **Modifier**.
1. Dans la section **Modifier les paramètres de point-in-time restauration**, décochez la case **Activer la Point-in-time restauration**.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Cassandra Query Language (CQL) ]
**Désactiver le PITR pour une table à l'aide de CQL**
+ Pour désactiver le PITR pour une table existante, exécutez la commande CQL suivante.
```
ALTER TABLE mykeyspace.mytable
WITH custom_properties = {'point_in_time_recovery': {'status': 'disabled'}}
```
------
#### [ CLI ]
**Désactivez le PITR pour une table à l'aide du AWS CLI**
+ Pour désactiver le PITR pour une table existante, exécutez la AWS CLI commande suivante.
```
aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --point-in-time-recovery 'status=DISABLED'
```
------
# Restaurer une table à partir d'une sauvegarde à un moment précis dans Amazon Keyspaces
La section suivante explique comment restaurer une table Amazon Keyspaces existante à un moment précis.
**Note**
Cette procédure suppose que la table que vous utilisez a été configurée avec la fonction point-in-time de restauration. Pour activer le PITR pour une table, consultez[Configurer le PITR pour une table dans Amazon Keyspaces](configure_PITR.md).
**Important**
Pendant qu'une restauration est en cours, ne modifiez ni ne supprimez les politiques Gestion des identités et des accès AWS (IAM) qui accordent au principal IAM (par exemple, utilisateur, groupe ou rôle) l'autorisation d'effectuer la restauration. Sinon, il peut en résulter un comportement inattendu. Par exemple, si vous supprimez les autorisations d'écriture pour une table alors que celle-ci est en cours de restauration, l'`RestoreTableToPointInTime`opération sous-jacente ne peut écrire aucune des données restaurées dans la table.
Vous ne pouvez modifier ou supprimer des autorisations qu'une fois l'opération de restauration terminée.
------
#### [ Console ]
**Restaurer une table à un moment précis à l'aide de la console**
1. [Connectez-vous à la AWS Management Console console Amazon Keyspaces et ouvrez-la chez https://console.aws.amazon.com/keyspaces/ vous.](https://console.aws.amazon.com/keyspaces/home)
1. Dans le volet de navigation sur le côté gauche de la console, choisissez **Tables**.
1. Dans la liste des tables, choisissez la table que vous souhaitez restaurer.
1. Dans l'onglet **Sauvegardes** du tableau, dans la section **Point-in-time de restauration**, choisissez **Restaurer**.
1. Pour le nouveau nom de table, entrez un nouveau nom pour la table restaurée, par exemple**mytable\$1restored**.
1. Pour définir le moment de l'opération de restauration, vous pouvez choisir entre deux options :
+ Sélectionnez l'heure la **plus ancienne** préconfigurée.
+ Sélectionnez **Spécifier la date et l'heure**, puis entrez la date et l'heure auxquelles vous souhaitez restaurer la nouvelle table.
**Note**
Vous pouvez effectuer une restauration à n'importe quel moment dans le **plus** bref délai et à l'heure actuelle. Amazon Keyspaces restaure les données de votre table dans leur état en fonction de la date et de l'heure sélectionnées (day:hour:minute:second).
1. Choisissez **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é, le statut de la table restaurée passe à **Actif**.
------
#### [ Cassandra Query Language (CQL) ]
**Restaurer une table à un point dans le temps à l'aide de CQL**
1. Vous pouvez rétablir une table active point-in-time entre l'heure actuelle `earliest_restorable_timestamp` et l'heure actuelle. L'heure actuelle est la valeur par défaut.
Pour confirmer que la point-in-time restauration est activée pour la table, interrogez le `system_schema_mcs.tables` comme indiqué dans cet exemple.
```
SELECT custom_properties
FROM system_schema_mcs.tables
WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
```
Point-in-time la restauration est activée comme indiqué dans l'exemple de sortie suivant.
```
custom_properties
-----------------
{
...,
"point_in_time_recovery": {
"earliest_restorable_timestamp":"2020-06-30T19:19:21.175Z"
"status":"enabled"
}
}
```
1.
+ Rétablissez le tableau à l'heure actuelle. Lorsque vous omettez la `WITH restore_timestamp = ...` clause, l'horodatage actuel est utilisé.
```
RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable;
```
+ Vous pouvez également effectuer une restauration à un moment précis, défini par un `restore_timestamp` au format ISO 8601. Vous pouvez spécifier n'importe quel instant dans le passé au cours des 35 derniers jours. Par exemple, la commande suivante restaure la table à la `EarliestRestorableDateTime`.
```
RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable
WITH restore_timestamp = '2020-06-30T19:19:21.175Z';
```
Pour une description complète de la syntaxe, voir [RESTAURER LA TABLE](cql.ddl.table.md#cql.ddl.table.restore) la référence du langage.
1. Pour vérifier que la restauration de la table a réussi, interrogez le `system_schema_mcs.tables` pour confirmer l'état de la table.
```
SELECT status
FROM system_schema_mcs.tables
WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable_restored'
```
La requête affiche le résultat suivant.
```
status
------
RESTORING
```
La table en cours de restauration s'affiche avec le statut **Restauration en cours**. Une fois le processus de restauration terminé, le statut de la table passe à **Actif**.
------
#### [ CLI ]
**Restaurez un tableau à un point dans le temps à l'aide du AWS CLI**
1. Créez une table simple nommée sur `myTable` laquelle le PITR est activé. La commande a été divisée en lignes distinctes pour des raisons de lisibilité.
```
aws keyspaces create-table --keyspace-name 'myKeyspace' --table-name 'myTable'
--schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]'
--point-in-time-recovery 'status=ENABLED'
```
1. Vérifiez les propriétés de la nouvelle table et vérifiez le `earliestRestorableTimestamp` PITR.
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
La sortie de cette commande renvoie ce qui suit.
```
{
"keyspaceName": "myKeyspace",
"tableName": "myTable",
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable",
"creationTimestamp": "2022-06-20T14:34:57.049000-07:00",
"status": "ACTIVE",
"schemaDefinition": {
"allColumns": [
{
"name": "id",
"type": "int"
},
{
"name": "date",
"type": "timestamp"
},
{
"name": "name",
"type": "text"
}
],
"partitionKeys": [
{
"name": "id"
}
],
"clusteringKeys": [],
"staticColumns": []
},
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": "2022-06-20T14:34:57.049000-07:00"
},
"encryptionSpecification": {
"type": "AWS_OWNED_KMS_KEY"
},
"pointInTimeRecovery": {
"status": "ENABLED",
"earliestRestorableTimestamp": "2022-06-20T14:35:13.693000-07:00"
},
"defaultTimeToLive": 0,
"comment": {
"message": ""
}
}
```
1.
+ Pour restaurer un tableau à un point dans le temps, spécifiez un `restore_timestamp` au format ISO 8601. Vous pouvez choisir n'importe quel moment au cours des 35 derniers jours à intervalles d'une seconde. Par exemple, la commande suivante restaure la table à la `EarliestRestorableDateTime`.
```
aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored' --restore-timestamp "2022-06-20 21:35:14.693"
```
La sortie de cette commande renvoie l'ARN de la table restaurée.
```
{
"restoredTableARN": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable_restored"
}
```
+ Pour rétablir l'heure actuelle de la table, vous pouvez omettre le `restore-timestamp` paramètre.
```
aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored1'"
```
------
# Restaurer une table supprimée à l'aide d'Amazon Keyspaces PITR
La procédure suivante indique comment restaurer une table supprimée depuis la sauvegarde jusqu'au moment de sa suppression. Vous pouvez le faire en utilisant CQL ou le AWS CLI.
**Note**
Cette procédure suppose que le PITR a été activé sur la table supprimée.
------
#### [ Cassandra Query Language (CQL) ]
**Restaurer une table supprimée à l'aide de CQL**
1. Pour confirmer que point-in-time la restauration est activée pour une table supprimée, interrogez la table système. Seules les tables pour lesquelles point-in-time la restauration est activée sont affichées.
```
SELECT custom_properties
FROM system_schema_mcs.tables_history
WHERE keyspace_name = 'mykeyspace' AND table_name = 'my_table';
```
La requête affiche le résultat suivant.
```
custom_properties
------------------
{
...,
"point_in_time_recovery":{
"restorable_until_time":"2020-08-04T00:48:58.381Z",
"status":"enabled"
}
}
```
1. Restaurez le tableau au moment de sa suppression à l'aide de l'exemple d'instruction suivant.
```
RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable;
```
------
#### [ CLI ]
**Restaurez une table supprimée à l'aide du AWS CLI**
1. Supprimez une table que vous avez créée précédemment et sur laquelle le PITR est activé. Voici un exemple de commande.
```
aws keyspaces delete-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
1. Restaurez la table supprimée au moment de sa suppression à l'aide de la commande suivante.
```
aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored2'
```
La sortie de cette commande renvoie l'ARN de la table restaurée.
```
{
"restoredTableARN": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable_restored2"
}
```
------