As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Faça backup e restaure dados com point-in-time recuperação para Amazon Keyspaces
Point-in-time a recuperação (PITR) ajuda a proteger suas tabelas do Amazon Keyspaces contra operações acidentais de gravação ou exclusão, fornecendo backups contínuos dos dados da tabela.
Por exemplo, suponhamos que um script de teste seja gravado acidentalmente em uma tabela de produção do Amazon Keyspaces. Com a point-in-time recuperação, você pode restaurar os dados dessa tabela a qualquer segundo, já que a PITR foi ativada nos últimos 35 dias. Se você excluir uma tabela com a point-in-time recuperação ativada, poderá consultar os dados da tabela excluída por 35 dias (sem custo adicional) e restaurá-los ao estado em que estavam pouco antes do ponto de exclusão.
Você pode restaurar uma tabela do Amazon Keyspaces em um determinado momento usando o console, o AWS SDK e o () ou a Cassandra Query Language AWS Command Line Interface (CQL AWS CLI). Para obter mais informações, consulte [Use a point-in-time recuperação no Amazon Keyspaces](PointInTimeRecovery_Tutorial.md).
Point-in-time as operações não têm impacto no desempenho ou na disponibilidade da tabela base, e a restauração de uma tabela não consome taxa de transferência adicional.
Para obter informações sobre cotas PITR, consulte [Cotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md).
Para obter informações sobre preços, consulte o [Amazon Keyspaces (para Apache Cassandra)](https://aws.amazon.com/keyspaces/pricing).
**Topics**
+ [Como point-in-time a recuperação funciona no Amazon Keyspaces](PointInTimeRecovery_HowItWorks.md)
+ [Use a point-in-time recuperação no Amazon Keyspaces](PointInTimeRecovery_Tutorial.md)
# Como point-in-time a recuperação funciona no Amazon Keyspaces
Esta seção fornece uma visão geral de como a point-in-time recuperação do Amazon Keyspaces (PITR) funciona. Para obter mais informações sobre preços, consulte o [Amazon Keyspaces (para Apache Cassandra)](https://aws.amazon.com/keyspaces/pricing).
**Topics**
+ [Janela de tempo para backups contínuos do PITR](#howitworks_backup_window)
+ [Configurações de restauração de PITR](#howitworks_backup_settings)
+ [Restauração PITR de tabelas criptografadas](#howitworks_backup_encryption)
+ [Restauração PITR de tabelas multirregionais](#howitworks_backup_multiRegion)
+ [Restauração PITR de tabelas com tipos definidos pelo usuário () UDTs](#howitworks_backup_udt)
+ [Tempo de restauração da tabela com PITR](#howitworks_restore_time)
+ [Amazon Keyspaces PITR e integração com serviços AWS](#howitworks_integration)
## Janela de tempo para backups contínuos do PITR
O PITR do Amazon Keyspaces usa duas datas e horas para manter o período em que os backups restauráveis estão disponíveis para uma tabela.
+ Hora de restauração mais antiga – Marca a hora do primeiro backup restaurável. O backup restaurável mais antigo remonta a 35 dias ou quando o PITR foi ativado, o que for mais recente. A janela máxima de backup de 35 dias não pode ser modificada.
+ Hora atual – A data e a hora do backup restaurável mais recente é a hora atual. Se nenhum registro de data e hora for fornecido durante uma restauração, a hora atual será usada.
Quando o PITR está habilitado, você pode restaurar para qualquer ponto no tempo entre `EarliestRestorableDateTime` e `CurrentTime`. Você só pode restaurar os dados da tabela em uma hora em que o PITR estava habilitado.
Se você desabilitar o PITR e depois reabilitá-lo novamente, redefinirá a hora de início do primeiro backup disponível para quando o PITR foi reabilitado. Isso significa que a desabilitação do PITR apaga seu histórico de backup.
**nota**
As operações de linguagem de definição de dados (DDL) em tabelas, como alterações de esquema, são executadas de forma assíncrona. Você só pode ver as operações concluídas nos dados da tabela restaurada, mas talvez veja ações adicionais na tabela de origem se elas estavam em andamento no momento da restauração. Para ver uma lista de instruções DDL, consulte [Instruções DDL (linguagem de definição de dados) no Amazon Keyspaces](cql.ddl.md).
Uma tabela não precisa estar ativa para ser restaurada. Você também pode restaurar tabelas excluídas se o PITR estiver habilitado na tabela excluída e a exclusão tiver ocorrido na janela de backup (ou nos últimos 35 dias).
**nota**
Se uma nova tabela for criada com o mesmo nome qualificado (por exemplo, mykeyspace.mytable) de uma tabela excluída anteriormente, a tabela excluída não poderá mais ser restaurada. Se você tentar fazer isso pelo console, um aviso será exibido.
## Configurações de restauração de PITR
Quando você restaura uma tabela usando o PITR, o Amazon Keyspaces restaura o esquema e dados da tabela de origem para o estado com base na data e hora selecionado (`day:hour:minute:second`) em uma nova tabela. O PITR não sobrescreve as tabelas existentes.
Além do esquema e dos dados da tabela, o PITR restaura as `custom_properties` da tabela de origem. Ao contrário dos dados da tabela, que são restaurados com base na data e hora selecionadas entre a hora de restauração mais antiga e a hora atual, as propriedades personalizadas são sempre restauradas com base nas configurações da tabela na hora atual.
As configurações da tabela restaurada correspondem às configurações da tabela de origem com a data e a hora de quando a restauração foi iniciada. Se você desejar sobrescrever essas configurações durante a restauração, poderá fazer isso usando `WITH custom_properties`. As propriedades personalizadas incluem as configurações a seguir.
+ Modo de capacidade de leitura/gravação
+ Configurações de capacidade de throughput provisionada
+ Configurações de PITR
Se a tabela estiver no modo de capacidade provisionada com o ajuste de escala automático ativado, a operação de restauração também restaurará as configurações de ajuste de escala automático da tabela. Você pode sobrescrevê-los usando o parâmetro `autoscaling_settings` em CQL ou `autoScalingSpecification` com a CLI. Para obter mais informações sobre as configurações de ajuste de escala automático, consulte [Gerencia automaticamente a capacidade de throughput com o ajuste de escala automático do Amazon Keyspaces](autoscaling.md).
Quando você faz uma restauração completa da tabela, todas as configurações da tabela restaurada são originadas das configurações atuais da tabela de origem no momento da restauração.
Por exemplo, suponha que o throughput provisionado de uma tabela tenha sido reduzido recentemente para 50 unidades de capacidade de leitura e 50 unidades de capacidade de gravação. Em seguida, você restaura o estado da tabela para três semanas atrás. Neste momento, o throughput provisionado foi definido para 100 unidades de capacidade de leitura e 100 unidades de capacidade de gravação. Nesse caso, o Amazon Keyspaces restaura os dados da tabela para esse ponto no tempo, mas usa as configurações de throughput provisionadas atuais (50 unidades de capacidade de leitura e 50 unidades de capacidade de gravação).
As configurações a seguir não são restauradas e você deve configurá-las manualmente para a nova tabela.
+ Amazon Keyspaces altera fluxos de captura de dados (CDC)
+ AWS Identity and Access Management Políticas (IAM)
+ CloudWatch Métricas e alarmes da Amazon
+ Tags (podem ser adicionadas à instrução `RESTORE` do CQL usando `WITH TAGS`)
## Restauração PITR de tabelas criptografadas
Quando você restaura uma tabela usando o PITR, o Amazon Keyspaces restaura as configurações de criptografia da tabela de origem. Se a tabela foi criptografada com um Chave pertencente à AWS (padrão), ela será restaurada automaticamente com a mesma configuração. Se a tabela que você deseja restaurar foi criptografada usando uma chave gerenciada pelo cliente, a mesma chave gerenciada pelo cliente precisa estar acessível ao Amazon Keyspaces para restaurar os dados da tabela.
Você pode alterar as configurações de criptografia da tabela no momento da restauração. Para mudar de uma chave gerenciada pelo cliente Chave pertencente à AWS para uma chave gerenciada pelo cliente, você precisa fornecer uma chave gerenciada pelo cliente válida e acessível no momento da restauração.
Se você quiser mudar de uma chave gerenciada pelo cliente para uma Chave pertencente à AWS, confirme se o Amazon Keyspaces tem acesso à chave gerenciada pelo cliente da tabela de origem para restaurar a tabela com uma. Chave pertencente à AWS Para obter mais informações sobre configurações de criptografia em repouso para tabelas, consulte [Criptografia em repouso: como funciona no Amazon Keyspaces](encryption.howitworks.md).
**nota**
Se a tabela foi excluída porque o Amazon Keyspaces perdeu o acesso à sua chave gerenciada pelo cliente, você precisa garantir que a chave gerenciada pelo cliente esteja acessível ao Amazon Keyspaces antes de tentar restaurá-la. Uma tabela que foi criptografada com uma chave gerenciada pelo cliente não pode ser restaurada se o Amazon Keyspaces não tiver acesso a essa chave. Para obter mais informações, consulte [Solução de problemas de acesso por chave](https://docs.aws.amazon.com/kms/latest/developerguide/policy-evaluation.html) no Guia do AWS Key Management Service desenvolvedor.
## Restauração PITR de tabelas multirregionais
Você pode restaurar uma tabela multirregional usando o PITR. Para que a operação de restauração seja bem-sucedida, a PITR deve estar habilitada em todas as réplicas da tabela de origem e as tabelas de origem e de destino devem ser replicadas na mesma. Regiões da AWS
O Amazon Keyspaces restaura as configurações da tabela de origem em cada uma das Regiões replicadas que fazem parte do espaço de chaves. Você também pode substituir as configurações durante a operação de restauração. Para obter mais informações sobre as configurações que podem ser alteradas durante a restauração, consulte [Configurações de restauração de PITR](#howitworks_backup_settings).
Para obter mais informações sobre a replicação multirregional, consulte. [Como a replicação multirregional funciona no Amazon Keyspaces](multiRegion-replication_how-it-works.md)
## Restauração PITR de tabelas com tipos definidos pelo usuário () UDTs
Você pode restaurar uma tabela que usa UDTs. Para que a operação de restauração seja bem-sucedida, o referenciado UDTs deve existir e ser válido no keyspace.
Se algum UDT necessário estiver ausente quando você tentar restaurar uma tabela, o Amazon Keyspaces tentará restaurar o esquema do UDT automaticamente e, em seguida, continuará restaurando a tabela.
Se você removeu e recriou o UDT, o Amazon Keyspaces restaura o UDT com o novo esquema do UDT e rejeita a solicitação de restauração da tabela usando o esquema original do UDT. Nesse caso, se você quiser restaurar a tabela com o esquema UDT antigo, poderá restaurar a tabela em um novo espaço de teclas. Quando você exclui e recria uma UDT, mesmo que o esquema da UDT recriada seja igual ao esquema da UDT excluída, a UDT recriada é considerada uma nova UDT. Nesse caso, o Amazon Keyspaces rejeita a solicitação para restaurar a tabela com o esquema antigo do UDT.
Se o UDT estiver ausente e o Amazon Keyspaces tentar restaurar o UDT, a tentativa falhará se você atingir o número máximo UDTs de para a conta na região.
Para obter mais informações sobre cotas de UDT e valores padrão, consulte. [Cotas e valores padrão para tipos definidos pelo usuário (UDTs) no Amazon Keyspaces](quotas.md#quotas-udts) Para obter mais informações sobre como trabalhar com UDTs, consulte[Tipos definidos pelo usuário (UDTs) no Amazon Keyspaces](udts.md).
## Tempo de restauração da tabela com PITR
O tempo necessário para restaurar uma tabela é baseado em vários fatores e nem sempre está correlacionado diretamente com o tamanho da tabela.
Veja a seguir algumas considerações sobre os tempos de restauração.
+ Os backups são restaurados para novas tabelas. Pode demorar até 20 minutos (mesmo se a tabela estiver vazia) para executar todas as ações necessárias para criar a nova tabela e iniciar o processo de restauração.
+ Os tempos de restauração de tabelas grandes com modelos de dados bem distribuídos podem ser de várias horas ou mais.
+ Se a tabela de origem tiver dados com distorção significativa, o tempo de restauração poderá aumentar. Por exemplo, se a chave primária de uma tabela estiver usando o mês do ano como chave de partição e todos os dados forem do mês de dezembro, os dados estarão distorcidos.
Uma prática recomendada ao planejar a recuperação de desastres é documentar regularmente os tempos médios de conclusão da restauração e estabelecer como esses tempos afetam seu objetivo geral de tempo de recuperação.
## Amazon Keyspaces PITR e integração com serviços AWS
As seguintes operações de PITR são registradas usando AWS CloudTrail para permitir monitoramento e auditoria contínuos.
+ Crie uma nova tabela com o PITR habilitado ou desabilitado.
+ Habilite ou desabilite o PITR em uma tabela existente.
+ Restaure uma tabela ativa ou excluída.
Para obter mais informações, consulte [Registro de chamadas de API do Amazon Keyspaces com AWS CloudTrail](logging-using-cloudtrail.md).
Você pode realizar as seguintes ações usando CloudFormation.
+ Crie uma nova tabela com o PITR habilitado ou desabilitado.
+ Habilite ou desabilite o PITR em uma tabela existente.
Para obter mais informações, consulte [Referência de tipos de recursos do Cassandra](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Cassandra.html) no [CloudFormation Guia do usuário](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/).
# Use a point-in-time recuperação no Amazon Keyspaces
Com o Amazon Keyspaces (para Apache Cassandra), você pode restaurar tabelas em um momento específico usando Point-in-Time Restore (PITR). A PITR permite que você restaure uma tabela para um estado anterior nos últimos 35 dias, fornecendo recursos de proteção e recuperação de dados. Esse recurso é valioso em casos como exclusão acidental de dados, erros de aplicativos ou para teste. Você pode recuperar dados de forma rápida e eficiente, minimizando o tempo de inatividade e a perda de dados. As seções a seguir orientam você pelo processo de restauração de tabelas usando PITR no Amazon Keyspaces, garantindo a integridade dos dados e a continuidade dos negócios.
**Topics**
+ [Configurar permissões do IAM da tabela de restauração para o PITR do Amazon Keyspaces](howitworks_restore_permissions.md)
+ [Configurar PITR para uma tabela no Amazon Keyspaces](configure_PITR.md)
+ [Desativar a PITR para uma tabela do Amazon Keyspaces](disable_PITR.md)
+ [Restaurar uma tabela do backup para um determinado ponto no tempo no Amazon Keyspaces](restoretabletopointintime.md)
+ [Restaurar uma tabela excluída usando a PITR do Amazon Keyspaces](restoredeleted.md)
# Configurar permissões do IAM da tabela de restauração para o PITR do Amazon Keyspaces
Esta seção resume como configurar permissões para que um diretor AWS Identity and Access Management (IAM) restaure tabelas do Amazon Keyspaces. No IAM, a política gerenciada pela AWS `AmazonKeyspacesFullAccess` inclui as permissões para restaurar tabelas do Amazon Keyspaces. Para implementar uma política personalizada com o mínimo de permissões necessárias, considere os requisitos descritos na próxima seção.
Para restaurar uma tabela com sucesso, a entidade principal do IAM precisa das seguintes permissões mínimas:
+ `cassandra:Restore`: a ação de restauração é necessária para que a tabela de destino seja restaurada.
+ `cassandra:Select`: a ação de seleção é necessária para ler a tabela de origem.
+ `cassandra:TagResource`: a ação da tag é opcional e necessária somente se a operação de restauração adicionar tags.
Este é um exemplo de política que concede permissões mínimas necessárias a um usuário para restaurar tabelas no espaço de chaves `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*"
]
}
]
}
```
Permissões adicionais para restaurar uma tabela podem ser necessárias com base em outros atributos selecionados. Por exemplo, se a tabela de origem for criptografada em repouso com uma chave gerenciada pelo cliente, o Amazon Keyspaces deverá ter permissões para acessar a chave gerenciada pelo cliente da tabela de origem para restaurar a tabela com sucesso. Para obter mais informações, consulte [Restauração PITR de tabelas criptografadas](PointInTimeRecovery_HowItWorks.md#howitworks_backup_encryption).
Se você estiver usando políticas do IAM com [chaves de condição](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) para restringir o tráfego de entrada para fontes específicas, você deve garantir que o Amazon Keyspaces tenha permissão para realizar uma operação de restauração em nome da sua entidade principal. Você deve adicionar uma chave de condição `aws:ViaAWSService` à sua política do IAM se ela restringir o tráfego de entrada a qualquer uma das seguintes opções:
+ Endpoints da VPC com `aws:SourceVpce`
+ Intervalos de IP com `aws:SourceIp`
+ VPCs com `aws:SourceVpc`
A chave de condição `aws:ViaAWSService` permite acesso quando qualquer serviço da AWS faz uma solicitação usando as credenciais da entidade principal. Para obter mais informações, consulte [Elementos de política JSON do IAM: chave de condição](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) no *Guia do usuário do IAM*.
Veja a seguir um exemplo de uma política que restringe o tráfego de origem a um endereço IP específico e permite que o Amazon Keyspaces restaure uma tabela em nome da entidade 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"
}
}
}
]
}
```
Para ver um exemplo de política usando a chave de condição global `aws:ViaAWSService`, consulte [Políticas de endpoint de VPC e recuperação do Amazon point-in-time Keyspaces (PITR)](vpc-endpoints.md#VPC_PITR_restore).
# Configurar PITR para uma tabela no Amazon Keyspaces
Você pode configurar uma tabela no Amazon Keyspaces para operações de backup e restauração usando PITR com o console, o CQL e a AWS CLI.
Ao criar uma nova tabela usando CQL ou o AWS CLI, você deve habilitar explicitamente a PITR na instrução create table. Quando você cria uma tabela usando o console, a PITR será ativada por padrão.
Para saber como restaurar uma tabela, consulte [Restaurar uma tabela do backup para um determinado ponto no tempo no Amazon Keyspaces](restoretabletopointintime.md).
------
#### [ Console ]
**Configurar a PITR para uma tabela usando o console**
1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)
1. No painel de navegação, selecione **Tabelas** e selecione a tabela que você deseja editar.
1. Na guia **Backups**, selecione **Editar**.
1. Na seção **Editar configurações point-in-time de recuperação**, selecione **Ativar Point-in-time recuperação**.
1. Escolha **Salvar alterações**.
------
#### [ Cassandra Query Language (CQL) ]
**Configurar a PITR para uma tabela usando CQL**
1. Você pode gerenciar as configurações de PITR para tabelas usando a propriedade customizada `point_in_time_recovery`.
Para ativar a PITR ao criar uma tabela, você deve definir o status `point_in_time_recovery` para `enabled`. Você pode usar o seguinte comando CQL como exemplo.
```
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'}
}
```
**nota**
Se nenhuma propriedade personalizada de point-in-time recuperação for especificada, a point-in-time recuperação será desativada por padrão.
1. Para habilitar o PITR para uma tabela existente usando CQL, execute o comando CQL a seguir.
```
ALTER TABLE mykeyspace.mytable
WITH custom_properties = {'point_in_time_recovery': {'status': 'enabled'}}
```
------
#### [ CLI ]
**Configure o PITR para uma tabela usando o AWS CLI**
1. Você pode gerenciar as configurações de PITR para tabelas usando a API `UpdateTable`.
Para ativar a PITR ao criar uma tabela, você deve incluir `point-in-time-recovery 'status=ENABLED'` no comando de criação de tabela. Você pode usar o seguinte comando AWS CLI como exemplo. O comando foi dividido em linhas separadas para facilitar a leitura.
```
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'
```
**nota**
Se nenhum valor point-in-time de recuperação for especificado, a point-in-time recuperação será desativada por padrão.
1. Para confirmar a configuração point-in-time de recuperação de uma tabela, você pode usar o AWS CLI comando a seguir.
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
1. Para habilitar o PITR para uma tabela existente usando o AWS CLI, execute o comando a seguir.
```
aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --point-in-time-recovery 'status=ENABLED'
```
------
# Desativar a PITR para uma tabela do Amazon Keyspaces
Você pode desativar a PITR para uma tabela do Amazon Keyspaces a qualquer momento usando o console, o CQL ou a AWS CLI.
**Importante**
Desabilitar o PITR exclui seu histórico de backup imediatamente, mesmo se você reabilitar a PITR na tabela em 35 dias.
Para saber como restaurar uma tabela, consulte [Restaurar uma tabela do backup para um determinado ponto no tempo no Amazon Keyspaces](restoretabletopointintime.md).
------
#### [ Console ]
**Desativar a PITR para uma tabela usando o console**
1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)
1. No painel de navegação, selecione **Tabelas** e selecione a tabela que você deseja editar.
1. Na guia **Backups**, selecione **Editar**.
1. Na seção **Editar configurações point-in-time de recuperação**, desmarque a caixa de seleção **Ativar Point-in-time recuperação**.
1. Escolha **Salvar alterações**.
------
#### [ Cassandra Query Language (CQL) ]
**Desativar a PITR para uma tabela usando CQL**
+ Para desabilitar a PITR para uma tabela existente, execute o comando CQL a seguir.
```
ALTER TABLE mykeyspace.mytable
WITH custom_properties = {'point_in_time_recovery': {'status': 'disabled'}}
```
------
#### [ CLI ]
**Desative a PITR para uma tabela usando a AWS CLI**
+ Para desativar a PITR para uma tabela existente, execute o AWS CLI comando a seguir.
```
aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --point-in-time-recovery 'status=DISABLED'
```
------
# Restaurar uma tabela do backup para um determinado ponto no tempo no Amazon Keyspaces
A seção a seguir demonstra como restaurar uma tabela existente do Amazon Keyspaces para um ponto específico no tempo.
**nota**
Esse procedimento pressupõe que a tabela que você está usando tenha sido configurada com point-in-time recuperação. Para habilitar a PITR para uma tabela, consulte [Configurar PITR para uma tabela no Amazon Keyspaces](configure_PITR.md).
**Importante**
Enquanto uma restauração estiver em andamento, não modifique nem exclua as políticas AWS Identity and Access Management (IAM) que concedem permissão ao principal do IAM (por exemplo, usuário, grupo ou função) para realizar a restauração. Do contrário, pode haver um comportamento inesperado. Por exemplo, se você remover permissões de gravação de uma tabela enquanto ela estiver sendo restaurada, a operação `RestoreTableToPointInTime` subjacente não conseguirá gravar na tabela nenhum dos dados restaurados.
Você pode modificar ou excluir permissões somente depois que a operação de restauração é concluída.
------
#### [ Console ]
**Restaurar uma tabela para um ponto específico no tempo usando o console**
1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)
1. No painel de navegação, no lado esquerdo do console, selecione **Tables** (Tabelas).
1. Na lista de tabelas, escolha aquela que você quer restaurar.
1. Na guia **Backups** da tabela, na seção **Point-in-time Recuperação**, escolha **Restaurar**.
1. Para o nome da nova tabela, insira um nome para a tabela restaurada, por exemplo **mytable\$1restored**.
1. Para definir o ponto no tempo da operação de restauração, você pode escolher entre duas opções:
+ Selecione a hora **Mais antiga** pré-configurada.
+ Selecione **Especificar data e hora** e insira a data e a hora para as quais você deseja restaurar a nova tabela.
**nota**
É possível fazer a restauração para qualquer ponto no tempo dentro da hora **Mais antiga** e da hora atual. O Amazon Keyspaces restaura os dados da tabela para o estado com base na data e na hora selecionadas (dia:hora:minuto:segundo).
1. Selecione **Restaurar** para iniciar o processo de restauração.
A tabela que está sendo restaurada é mostrada com o status **Restoring (Em restauração)**. Quando o processo de restauração for concluído, o status da tabela restaurada mudará para **Ativo**.
------
#### [ Cassandra Query Language (CQL) ]
**Restaurar uma tabela para um ponto no tempo usando CQL**
1. Você pode restaurar uma tabela ativa para uma hora point-in-time entre `earliest_restorable_timestamp` e a hora atual. O padrão é a hora atual.
Para confirmar se a point-in-time recuperação está habilitada para a tabela, consulte o `system_schema_mcs.tables` conforme mostrado neste exemplo.
```
SELECT custom_properties
FROM system_schema_mcs.tables
WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
```
Point-in-time a recuperação é ativada conforme mostrado no exemplo de saída a seguir.
```
custom_properties
-----------------
{
...,
"point_in_time_recovery": {
"earliest_restorable_timestamp":"2020-06-30T19:19:21.175Z"
"status":"enabled"
}
}
```
1.
+ Restaure a tabela para a hora atual. Quando você omite a cláusula `WITH restore_timestamp = ...`, é usado o carimbo de data/hora atual.
```
RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable;
```
+ Você também pode restaurar para um ponto específico no tempo, definido por um `restore_timestamp` no formato ISO 8601. Você pode especificar qualquer ponto durante os últimos 35 dias. Por exemplo, o comando a seguir restaura a tabela para o `EarliestRestorableDateTime`.
```
RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable
WITH restore_timestamp = '2020-06-30T19:19:21.175Z';
```
Para obter uma descrição completa da sintaxe, consulte [RESTAURAR TABELA](cql.ddl.table.md#cql.ddl.table.restore) na referência de linguagem.
1. Para verificar se a restauração da tabela foi bem-sucedida, consulte o `system_schema_mcs.tables` para confirmar o status da tabela.
```
SELECT status
FROM system_schema_mcs.tables
WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable_restored'
```
A consulta mostra o a saída a seguir.
```
status
------
RESTORING
```
A tabela que está sendo restaurada é mostrada com o status **Restoring (Em restauração)**. Quando o processo de restauração for concluído, o status da tabela mudará para **Active (Ativo)**.
------
#### [ CLI ]
**Restaure uma tabela em um determinado momento usando o AWS CLI**
1. Criar uma tabela simples chamada `myTable` que tem a PITR ativada. O comando foi dividido em linhas separadas para facilitar a leitura.
```
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. Confirme as propriedades da nova tabela e revise `earliestRestorableTimestamp` para o PITR.
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
A saída deste comando retorna o seguinte.
```
{
"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.
+ Para restaurar uma tabela para um ponto no tempo, especifique um `restore_timestamp` no formato ISO 8601. É possível escolher qualquer ponto no tempo durante os últimos 35 dias em intervalos de um segundo. Por exemplo, o comando a seguir restaura a tabela para o `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"
```
A saída desse comando retornará o ARN da tabela restaurada.
```
{
"restoredTableARN": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable_restored"
}
```
+ Para restaurar a tabela para a hora atual, você pode omitir o parâmetro `restore-timestamp`.
```
aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored1'"
```
------
# Restaurar uma tabela excluída usando a PITR do Amazon Keyspaces
O procedimento a seguir mostra como restaurar uma tabela excluída do backup para o momento da exclusão. Você pode fazer isso usando CQL ou o. AWS CLI
**nota**
Esse procedimento pressupõe que o PITR foi ativado na tabela excluída.
------
#### [ Cassandra Query Language (CQL) ]
**Restaurar uma tabela excluída usando o CQL**
1. Para confirmar se a point-in-time recuperação está ativada para uma tabela excluída, consulte a tabela do sistema. Somente tabelas com point-in-time recuperação ativada são mostradas.
```
SELECT custom_properties
FROM system_schema_mcs.tables_history
WHERE keyspace_name = 'mykeyspace' AND table_name = 'my_table';
```
A consulta mostra o a saída a seguir.
```
custom_properties
------------------
{
...,
"point_in_time_recovery":{
"restorable_until_time":"2020-08-04T00:48:58.381Z",
"status":"enabled"
}
}
```
1. Restaure a tabela até o momento da exclusão com o exemplo de instrução a seguir.
```
RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable;
```
------
#### [ CLI ]
**Restaurar uma tabela excluída usando o AWS CLI**
1. Excluir uma tabela criada anteriormente com a PITR habilitada. O comando a seguir é um exemplo.
```
aws keyspaces delete-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
1. Restaure a tabela excluída até o momento da exclusão com o comando a seguir.
```
aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored2'
```
A saída desse comando retornará o ARN da tabela restaurada.
```
{
"restoredTableARN": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable_restored2"
}
```
------