Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Backup y restauración de datos con point-in-time recuperación para Amazon Keyspaces
Point-in-time recovery (PITR) ayuda a proteger sus tablas de Amazon Keyspaces de operaciones de escritura o eliminación accidentales al proporcionarle copias de seguridad continuas de los datos de las tablas.
Por ejemplo, suponga que un script de prueba escriba accidentalmente en una tabla de Amazon Keyspaces de producción. Con point-in-time la recuperación, puede restaurar los datos de esa tabla en cualquier momento desde que se activó el PITR en los últimos 35 días. Si eliminas una tabla con la point-in-time recuperación habilitada, puedes consultar los datos de la tabla eliminada durante 35 días (sin coste adicional) y restaurarlos al estado en el que se encontraban justo antes del momento de la eliminación.
Puede restaurar una tabla de Amazon Keyspaces a un punto en el tiempo mediante la consola, el AWS SDK y el lenguaje de consultas AWS Command Line Interface (AWS CLI) o Cassandra Query Language (CQL). Para obtener más información, consulte [Utilice point-in-time la recuperación en Amazon Keyspaces](PointInTimeRecovery_Tutorial.md).
Point-in-time las operaciones no afectan al rendimiento ni a la disponibilidad de la tabla base, y la restauración de una tabla no consume un rendimiento adicional.
Para obtener información sobre las cuotas de PITR, consulte [Cuotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md).
Para obtener información sobre precios, consulte [Precios de Amazon Keyspaces (para Apache Cassandra)](https://aws.amazon.com/keyspaces/pricing).
**Topics**
+ [Cómo funciona point-in-time la recuperación en Amazon Keyspaces](PointInTimeRecovery_HowItWorks.md)
+ [Utilice point-in-time la recuperación en Amazon Keyspaces](PointInTimeRecovery_Tutorial.md)
# Cómo funciona point-in-time la recuperación en Amazon Keyspaces
En esta sección se proporciona información general sobre cómo funciona la point-in-time recuperación de Amazon Keyspaces (PITR). Para obtener más información sobre precios, consulte [Precios de Amazon Keyspaces (para Apache Cassandra)](https://aws.amazon.com/keyspaces/pricing).
**Topics**
+ [Periodo de copias de seguridad continuas con PITR](#howitworks_backup_window)
+ [Ajustes de restauración de PITR](#howitworks_backup_settings)
+ [Restauración de tablas cifradas con PITR](#howitworks_backup_encryption)
+ [Restauración de tablas multirregión con PITR](#howitworks_backup_multiRegion)
+ [Restauración PITR de tablas con tipos definidos por el usuario () UDTs](#howitworks_backup_udt)
+ [Tiempo de restauración de la tabla con PITR](#howitworks_restore_time)
+ [Amazon Keyspaces, PITR e integración con servicios AWS](#howitworks_integration)
## Periodo de copias de seguridad continuas con PITR
La PITR de Amazon Keyspaces utiliza dos marcas de tiempo para mantener el periodo de disponibilidad de copias de seguridad restaurables de una tabla.
+ Hora para restauración más antigua: marca la hora de la copia de seguridad restaurable más antigua. La copia de seguridad restaurable más antigua se remonta hasta 35 días o hasta el momento en que se habilitó PITR, lo que sea más reciente. El periodo máximo de 35 días de copias de seguridad no se puede modificar.
+ Hora actual: la marca de tiempo de la última copia de seguridad restaurable es la hora actual. Si no se proporciona ninguna marca de tiempo durante una restauración, se utiliza la hora actual.
Cuando PITR está habilitada, puede restaurar a cualquier punto en el tiempo entre `EarliestRestorableDateTime` y `CurrentTime`. Solo puede restaurar los datos de una tabla a un momento en que la PITR estuviera habilitada.
Si deshabilita la PITR y más tarde la vuelve a habilitar, restablece la hora inicial de la primera copia de seguridad disponible a la hora en que se volvió a habilitar la PITR. Esto significa que al deshabilitar la PITR se elimina el historial de copias de seguridad.
**nota**
Las operaciones de lenguaje de definición de datos (DDL) en las tablas, al igual que los cambios de esquema, se realizan de forma asíncrona. Solo puede ver las operaciones completadas en los datos de su tabla restaurada, pero podría ver acciones adicionales en su tabla de origen si estaban en curso en el momento de la restauración. Para obtener una lista de las sentencias DDL, consulte [Instrucciones DDL (lenguaje de definición de datos) en Amazon Keyspaces](cql.ddl.md).
Una tabla no necesita estar activa para poder restaurarla. También puede restaurar tablas eliminadas si PITR estaba habilitado en la tabla eliminada y la eliminación se produjo dentro del periodo de copia de seguridad (o en los últimos 35 días).
**nota**
Si se crea una nueva tabla con el mismo nombre cualificado (por ejemplo, mykeyspace.mytable) que una tabla previamente eliminada, la tabla eliminada ya no se puede restaurar. Si intenta hacerlo desde la consola, aparece una advertencia.
## Ajustes de restauración de PITR
Al restaurar una tabla mediante la PITR, Amazon Keyspaces restaura el esquema y los datos de su tabla de origen al estado basado en la marca de tiempo seleccionada (`day:hour:minute:second`) en una nueva tabla. La PITR no sobrescribe las tablas existentes.
Además del esquema y los datos de la tabla, la PITR restaura las `custom_properties` de la tabla de origen. A diferencia de los datos de la tabla, que se restauran en función de la marca de tiempo seleccionada entre la hora de restauración más antigua y la hora actual, las propiedades personalizadas siempre se restauran en función de la configuración de la tabla según la hora actual.
La configuración de la tabla restaurada coincide con la configuración de la tabla de origen con la marca de tiempo de cuando se inició la restauración. Si desea sobrescribir estos ajustes durante la restauración, puede hacerlo utilizando `WITH custom_properties`. Las propiedades personalizadas incluyen los siguientes ajustes.
+ Modo de capacidad de lectura/escritura
+ Ajustes de capacidad de rendimiento aprovisionada
+ Ajustes de PITR
Si la tabla está en modo de capacidad aprovisionada con el escalado automático activado, la operación de restauración también restaura la configuración de escalado automático de la tabla. Puede sobrescribir esta configuración mediante el parámetro `autoscaling_settings` en CQL o con `autoScalingSpecification` en la CLI. Para obtener más información sobre la configuración de escalado automático, consulte [Administración automática de la capacidad de rendimiento con el escalado automático de Amazon Keyspaces](autoscaling.md).
Cuando realiza una restauración de tabla completa, todos los valores de la tabla restaurada provienen de la configuración actual de la tabla de origen en el momento de la restauración.
Por ejemplo, suponga que el rendimiento aprovisionado de una tabla se acaba de reducir a 50 unidades de capacidad de lectura y 50 unidades de capacidad de escritura. A continuación, restaura el estado de la tabla a hace tres semanas. En ese momento, su rendimiento aprovisionado estaba establecido en 100 unidades de capacidad de lectura y 100 unidades de capacidad de escritura. En este caso, Amazon Keyspaces restaura los datos de su tabla a ese momento, pero utiliza la configuración de rendimiento aprovisionada actual (50 unidades de capacidad de lectura y 50 unidades de capacidad de escritura).
Los siguientes ajustes no se restauran y debe configurarlos manualmente para la nueva tabla.
+ Amazon Keyspaces cambia las transmisiones de captura de datos (CDC)
+ AWS Identity and Access Management Políticas (IAM)
+ CloudWatch Métricas y alarmas de Amazon
+ Etiquetas (se pueden añadir a la sentencia CQL `RESTORE` utilizando `WITH TAGS`)
## Restauración de tablas cifradas con PITR
Al restaurar una tabla mediante la PITR, Amazon Keyspaces restaura la configuración de cifrado de su tabla de origen. Si la tabla se cifró con una Clave propiedad de AWS (opción predeterminada), se restaura automáticamente con la misma configuración. Si la tabla que desea restaurar se cifró con una clave administrada por el cliente, es necesario que Amazon Keyspaces pueda acceder a la misma clave administrada por el cliente para restaurar los datos de la tabla.
Puede cambiar la configuración de cifrado de la tabla en el momento de la restauración. Para cambiar de una Clave propiedad de AWS clave administrada por el cliente, debe proporcionar una clave administrada por el cliente válida y accesible en el momento de la restauración.
Si quieres cambiar de una clave gestionada por el cliente a una Clave propiedad de AWS, confirma que Amazon Keyspaces tiene acceso a la clave gestionada por el cliente de la tabla de origen para restaurar la tabla con una. Clave propiedad de AWS Para obtener más información sobre la configuración del cifrado en reposo de tablas, consulte [Cifrado en reposo: Cómo funciona en Amazon Keyspaces](encryption.howitworks.md).
**nota**
Si la tabla se eliminó porque Amazon Keyspaces perdió el acceso a su clave administrada por el cliente, debe asegurarse de que Amazon Keyspaces tenga acceso a la clave administrada por el cliente antes de intentar restaurar la tabla. Una tabla que se cifró con una clave administrada por el cliente no puede restaurarse si Amazon Keyspaces no tiene acceso a dicha clave. Para obtener más información, consulte [Solución de problemas de acceso a las claves](https://docs.aws.amazon.com/kms/latest/developerguide/policy-evaluation.html) en la Guía para AWS Key Management Service desarrolladores.
## Restauración de tablas multirregión con PITR
Puede restaurar una tabla multirregión con PITR. Para que la operación de restauración se realice correctamente, la PITR debe estar habilitada en todas las réplicas de la tabla de origen y tanto la tabla de origen como la de destino deben estar replicadas en la misma. Regiones de AWS
Amazon Keyspaces restaura la configuración de la tabla de origen en cada una de las regiones replicadas que forman parte del espacio de claves. También puede anular los ajustes durante la operación de restauración. Para obtener más información sobre los ajustes que se pueden modificar durante la restauración, consulte [Ajustes de restauración de PITR](#howitworks_backup_settings).
Para obtener más información sobre la replicación multirregional, consulte. [Cómo funciona la replicación multirregional en Amazon Keyspaces](multiRegion-replication_how-it-works.md)
## Restauración PITR de tablas con tipos definidos por el usuario () UDTs
Puede restaurar una tabla que utilice. UDTs Para que la operación de restauración se realice correctamente, las referencias UDTs deben existir y ser válidas en el espacio de claves.
Si falta alguna UDT requerida al intentar restaurar una tabla, Amazon Keyspaces intentará restaurar el esquema de UDT automáticamente y, a continuación, seguirá restaurando la tabla.
Si ha eliminado y vuelto a crear la UDT, Amazon Keyspaces restaura la UDT con el nuevo esquema de la UDT y rechaza la solicitud de restauración de la tabla con el esquema UDT original. En este caso, si desea restaurar la tabla con el esquema UDT anterior, puede restaurar la tabla en un espacio de claves nuevo. Al eliminar y volver a crear una UDT, incluso si el esquema de la UDT recreada es el mismo que el esquema de la UDT eliminada, la UDT recreada se considera una UDT nueva. En este caso, Amazon Keyspaces rechaza la solicitud de restaurar la tabla con el esquema UDT anterior.
Si falta la UDT y Amazon Keyspaces intenta restaurarla, el intento fallará si se ha alcanzado el número máximo UDTs de para la cuenta en la región.
Para obtener más información sobre las cuotas de UDT y los valores predeterminados, consulte. [Cuotas y valores predeterminados para los tipos definidos por el usuario (UDTs) en Amazon Keyspaces](quotas.md#quotas-udts) Para obtener más información sobre cómo trabajar con UDTs, consulte[Tipos definidos por el usuario (UDTs) en Amazon Keyspaces](udts.md).
## Tiempo de restauración de la tabla con PITR
El tiempo necesario para restaurar una tabla depende de múltiples factores y no siempre se correlaciona directamente con el tamaño de la tabla.
A continuación se exponen algunas consideraciones sobre tiempos de restauración.
+ Las copias de seguridad se restauran en una tabla nueva. Es posible que la demora para realizar todas las acciones destinadas a crear una tabla nueva e iniciar el proceso de restauración sea de hasta 20 minutos (aunque la tabla esté vacía).
+ El tiempo de restauración para tablas grandes con modelos de datos bien distribuidos puede ser de varias horas o más.
+ Si su tabla de origen contiene datos muy sesgados, el tiempo de restauración podría ser mayor. Por ejemplo, si la clave principal de su tabla utiliza el mes del año como clave de partición y todos sus datos son del mes de diciembre, tiene datos sesgados.
Una práctica recomendada a la hora de planificar la recuperación ante desastres es documentar regularmente los tiempos promedio de finalización de la restauración y establecer cómo estos tiempos afectan a su objetivo general de tiempo de recuperación.
## Amazon Keyspaces, PITR e integración con servicios AWS
Las siguientes operaciones del PITR se registran AWS CloudTrail para permitir la supervisión y la auditoría continuas.
+ Crear una nueva tabla con PITR habilitado o deshabilitado.
+ Habilitar o deshabilitar PITR en una tabla existente.
+ Restaurar una tabla activa o eliminada.
Para obtener más información, consulte [Registrar las llamadas a la API de Amazon Keyspaces con AWS CloudTrail](logging-using-cloudtrail.md).
Puede realizar las siguientes acciones de PITR con CloudFormation.
+ Crear una nueva tabla con PITR habilitado o deshabilitado.
+ Habilitar o deshabilitar PITR en una tabla existente.
Para obtener más información, consulte [Referencia de tipos de recursos de Cassandra](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Cassandra.html) en la [Guía del usuario de CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/).
# Utilice point-in-time la recuperación en Amazon Keyspaces
Con Amazon Keyspaces (para Apache Cassandra), puede restaurar tablas a un punto específico en el tiempo mediante Point-in-Time Restore (PITR). La PITR le permite restaurar una tabla a un estado anterior de los últimos 35 días, lo que proporciona capacidades de protección y recuperación de datos. Esta característica resulta útil en casos como la eliminación accidental de datos, los errores de aplicación o la realización de pruebas. Puede recuperar los datos de forma rápida y eficiente, lo que minimiza el tiempo de inactividad y la pérdida de datos. En las siguientes secciones le guiamos a lo largo del proceso de restauración de tablas con la PITR en Amazon Keyspaces para garantizar la integridad de los datos y la continuidad empresarial.
**Topics**
+ [Configuración de los permisos de IAM para la restauración de tablas con la PITR de Amazon Keyspaces](howitworks_restore_permissions.md)
+ [Configuración de la PITR para una tabla en Amazon Keyspaces](configure_PITR.md)
+ [Desactivación de la PITR para una tabla de Amazon Keyspaces](disable_PITR.md)
+ [Restauración de una tabla desde una copia de seguridad en un momento dado en Amazon Keyspaces](restoretabletopointintime.md)
+ [Restauración de una tabla eliminada con la PITR de Amazon Keyspaces](restoredeleted.md)
# Configuración de los permisos de IAM para la restauración de tablas con la PITR de Amazon Keyspaces
En esta sección se resume cómo configurar los permisos para que una entidad principal AWS Identity and Access Management (IAM) restaure las tablas de Amazon Keyspaces. En IAM, la política administrada `AmazonKeyspacesFullAccess` de AWS incluye los permisos para restaurar tablas de Amazon Keyspaces. Para implementar una política personalizada con los permisos mínimos requeridos, tenga en cuenta los requisitos que se describen en la siguiente sección.
Para restaurar correctamente una tabla, la entidad principal de IAM necesita los siguientes permisos mínimos:
+ `cassandra:Restore`: la acción restaurar es necesaria para restaurar la tabla de destino.
+ `cassandra:Select`: la acción seleccionar es necesaria para leer desde la tabla de origen.
+ `cassandra:TagResource`: la acción etiquetar es opcional y solo se requiere si la operación de restauración añade etiquetas.
Este es un ejemplo de una política que concede los permisos mínimos necesarios a un usuario para restaurar tablas en el espacio de claves `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*"
]
}
]
}
```
Es posible que se requieran permisos adicionales para restaurar una tabla en función de otras características seleccionadas. Por ejemplo, si la tabla de origen está cifrada en reposo con una clave administrada por el cliente, Amazon Keyspaces debe tener permisos para acceder a la clave administrada por el cliente de la tabla de origen a fin de restaurar correctamente la tabla. Para obtener más información, consulte [Restauración de tablas cifradas con PITR](PointInTimeRecovery_HowItWorks.md#howitworks_backup_encryption).
Si utiliza políticas de IAM con [claves de condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) para restringir el tráfico entrante a orígenes específicos, debe asegurarse de que Amazon Keyspaces tenga permiso para realizar una operación de restauración en nombre de su entidad principal. Debe añadir una clave de condición `aws:ViaAWSService` a su política de IAM si su política restringe el tráfico entrante a cualquiera de los siguientes:
+ Puntos de conexión de VPC con `aws:SourceVpce`
+ Rangos IP con `aws:SourceIp`
+ VPCs con `aws:SourceVpc`
La clave de condición `aws:ViaAWSService` permite el acceso cuando cualquier servicio de AWS realiza una solicitud empleando las credenciales de la entidad principal. Para obtener más información, consulte [Elementos JSON de la política de IAM: Clave de condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) en la *Guía del usuario de IAM*.
A continuación se muestra un ejemplo de política que restringe el tráfico de origen a una dirección IP específica y permite a Amazon Keyspaces restaurar una tabla en nombre de la entidad 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 un ejemplo de política que utilice la clave de condición global de `aws:ViaAWSService`, consulte [Políticas de puntos de conexión de VPC y recuperación de Amazon Keyspaces point-in-time (PITR)](vpc-endpoints.md#VPC_PITR_restore).
# Configuración de la PITR para una tabla en Amazon Keyspaces
Puede configurar una tabla en Amazon Keyspaces para las operaciones de copia de seguridad y restauración mediante la PITR con la consola, CQL y la AWS CLI.
Al crear una tabla nueva con CQL o el AWS CLI, debe habilitar explícitamente el PITR en la instrucción de creación de tabla. Al crear una tabla nueva con la consola, la PITR estará habilitada de forma predeterminada.
Para obtener información sobre cómo restaurar una tabla, consulte [Restauración de una tabla desde una copia de seguridad en un momento dado en Amazon Keyspaces](restoretabletopointintime.md).
------
#### [ Console ]
**Configuración de la PITR para una tabla con la consola**
1. [Inicia sesión en la Consola de administración de AWS consola de Amazon Keyspaces y ábrela desde casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)
1. En el panel de navegación, elija **Tablas** y seleccione la tabla que desee editar.
1. En la pestaña **Copias de seguridad**, elija **Editar**.
1. En la sección **Editar la configuración de point-in-time recuperación**, selecciona **Habilitar la Point-in-time recuperación**.
1. Seleccione **Save changes (Guardar cambios)**.
------
#### [ Cassandra Query Language (CQL) ]
**Configuración de la PITR para una tabla con CQL**
1. Puede administrar la configuración de PITR para las tablas mediante la propiedad personalizada `point_in_time_recovery`.
Para habilitar la PITR en el momento de crear una nueva tabla, debe configurar el estado de `point_in_time_recovery` como `enabled`. Puede usar el siguiente comando CQL como ejemplo.
```
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**
Si no se especifica ninguna point-in-time propiedad personalizada de point-in-time recuperación, la recuperación está deshabilitada de forma predeterminada.
1. Para habilitar PITR en una tabla existente mediante CQL, ejecute el siguiente comando CQL.
```
ALTER TABLE mykeyspace.mytable
WITH custom_properties = {'point_in_time_recovery': {'status': 'enabled'}}
```
------
#### [ CLI ]
**Configure el PITR para una tabla mediante el AWS CLI**
1. Puede administrar la configuración de PITR para las tablas con la API `UpdateTable`.
Para habilitar la PITR en el momento de crear una nueva tabla, debe incluir `point-in-time-recovery 'status=ENABLED'` en el comando de creación de la tabla. Puede usar el siguiente comando de la AWS CLI como ejemplo. El comando se ha dividido en líneas separadas para mejorar la legibilidad.
```
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**
Si no se especifica ningún valor de point-in-time recuperación, la point-in-time recuperación está deshabilitada de forma predeterminada.
1. Para confirmar la configuración de point-in-time recuperación de una tabla, puede usar el siguiente AWS CLI comando.
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
1. Para habilitar el PITR en una tabla existente mediante el AWS CLI, ejecute el siguiente comando.
```
aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --point-in-time-recovery 'status=ENABLED'
```
------
# Desactivación de la PITR para una tabla de Amazon Keyspaces
Puede desactivar la PITR para una tabla de Amazon Keyspaces en cualquier momento mediante la consola, CQL o la AWS CLI.
**importante**
Al deshabilitar la PITR se elimina de inmediato el historial de copias de seguridad, sin importar si vuelve a habilitar la PITR en la tabla en un plazo de 35 días.
Para obtener información sobre cómo restaurar una tabla, consulte [Restauración de una tabla desde una copia de seguridad en un momento dado en Amazon Keyspaces](restoretabletopointintime.md).
------
#### [ Console ]
**Desactivación de la PITR para una tabla con la consola**
1. [Inicia sesión en la Consola de administración de AWS consola de Amazon Keyspaces y ábrela desde casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)
1. En el panel de navegación, elija **Tablas** y seleccione la tabla que desee editar.
1. En la pestaña **Copias de seguridad**, elija **Editar**.
1. En la sección **Editar la configuración de point-in-time recuperación**, desactive la casilla **Habilitar la Point-in-time recuperación**.
1. Seleccione **Save changes (Guardar cambios)**.
------
#### [ Cassandra Query Language (CQL) ]
**Desactivación de la PITR para una tabla con CQL**
+ Para deshabilitar la PITR para una tabla existente, ejecute el siguiente comando CQL.
```
ALTER TABLE mykeyspace.mytable
WITH custom_properties = {'point_in_time_recovery': {'status': 'disabled'}}
```
------
#### [ CLI ]
**Deshabilite el PITR para una tabla mediante el AWS CLI**
+ Para deshabilitar la PITR en una tabla existente, ejecute el siguiente AWS CLI comando.
```
aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --point-in-time-recovery 'status=DISABLED'
```
------
# Restauración de una tabla desde una copia de seguridad en un momento dado en Amazon Keyspaces
En la siguiente sección se muestra cómo restaurar una tabla existente de Amazon Keyspaces en un momento dado especificado.
**nota**
En este procedimiento se presupone que la tabla que está utilizando se ha configurado con recuperación. point-in-time Para habilitar la PITR en una tabla, consulte [Configuración de la PITR para una tabla en Amazon Keyspaces](configure_PITR.md).
**importante**
Mientras se esté realizando una restauración, no modifique ni elimine las políticas AWS Identity and Access Management (de IAM) que otorgan permiso al principal de IAM (por ejemplo, al usuario, grupo o rol) para realizar la restauración. De lo contrario, puede ocurrir un comportamiento inesperado. Por ejemplo, si se quitan los permisos de escritura de una tabla mientras se restaura, la operación `RestoreTableToPointInTime` subyacente no puede escribir ninguno de los datos restaurados en la tabla.
Puede modificar o eliminar los permisos solo después de que finalice la operación de restauración.
------
#### [ Console ]
**Restauración de una tabla en un momento dado mediante la consola**
1. [Inicia sesión en la Consola de administración de AWS consola de Amazon Keyspaces y ábrela desde casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)
1. En el panel de navegación del lado izquierdo de la consola, elija **Tablas**.
1. En la lista de tablas, elija la tabla que quiera restaurar.
1. En la pestaña **Copias** de seguridad de la tabla, en la sección **Point-in-time de recuperación**, selecciona **Restaurar**.
1. Para el nombre de la nueva tabla, escriba un nombre para la tabla restaurada, por ejemplo, **mytable\$1restored**.
1. Para definir el momento dado para la operación de restauración, puede elegir entre dos opciones:
+ Seleccione la hora **Más antigua** preconfigurada.
+ Seleccione **Especificar fecha y hora** e introduzca la fecha y hora a la que desea restaurar la nueva tabla.
**nota**
Puede restaurar a cualquier momento dado entre la hora **Más antigua** y la hora actual. Amazon Keyspaces restaura los datos de su tabla al estado basado en la fecha y hora seleccionadas (day:hour:minute:second).
1. Elija **Restaurar** para iniciar el proceso de restauración.
La tabla que se va a restaurar se muestra con el estado **Restaurando**. Una vez finalizado el proceso de restauración, el estado de la tabla restaurada cambia a **Activa**.
------
#### [ Cassandra Query Language (CQL) ]
**Restauración de una tabla en un momento dado con CQL**
1. Puede restaurar una tabla activa a una hora point-in-time intermedia `earliest_restorable_timestamp` y la hora actual. El valor predeterminado es la hora actual.
Para confirmar que point-in-time la recuperación de la tabla está habilitada, consulte la tabla tal y `system_schema_mcs.tables` como se muestra en este ejemplo.
```
SELECT custom_properties
FROM system_schema_mcs.tables
WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
```
Point-in-time la recuperación está habilitada, como se muestra en el siguiente ejemplo de salida.
```
custom_properties
-----------------
{
...,
"point_in_time_recovery": {
"earliest_restorable_timestamp":"2020-06-30T19:19:21.175Z"
"status":"enabled"
}
}
```
1.
+ Restaure la tabla a la hora actual. Si se omite la cláusula `WITH restore_timestamp = ...`, se utiliza la marca de tiempo actual.
```
RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable;
```
+ También puede restaurar a un punto específico en el tiempo, definido por una `restore_timestamp` en formato ISO 8601. Puede especificar cualquier momento de los últimos 35 días. Por ejemplo, el siguiente comando restaura la tabla al a fecha y hora del valor `EarliestRestorableDateTime`.
```
RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable
WITH restore_timestamp = '2020-06-30T19:19:21.175Z';
```
Para obtener una descripción completa de la sintaxis, consulte [RESTORE TABLE](cql.ddl.table.md#cql.ddl.table.restore) en la referencia del lenguaje.
1. Para comprobar que la restauración de la tabla se haya realizado correctamente, consulte `system_schema_mcs.tables` para confirmar el estado de la tabla.
```
SELECT status
FROM system_schema_mcs.tables
WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable_restored'
```
La consulta muestra la siguiente salida.
```
status
------
RESTORING
```
La tabla que se va a restaurar se muestra con el estado **Restaurando**. Una vez finalizado el proceso de restauración, el estado de la tabla cambia a **Activa**.
------
#### [ CLI ]
**Restaure una tabla a un punto en el tiempo mediante el AWS CLI**
1. Cree una tabla sencilla llamada `myTable` con la PITR habilitada. El comando se ha dividido en líneas separadas para mejorar la legibilidad.
```
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 las propiedades de la nueva tabla y revise la `earliestRestorableTimestamp` de la PITR.
```
aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
Este comando devuelve la siguiente salida.
```
{
"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 una tabla en un momento dado, especifique una `restore_timestamp` en formato ISO 8601. Puede elegir cualquier momento dado durante los últimos 35 días en intervalos de un segundo. Por ejemplo, el siguiente comando restaura la tabla al a fecha y hora del valor `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 salida de este comando devuelve el ARN de la tabla restaurada.
```
{
"restoredTableARN": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable_restored"
}
```
+ Para restaurar la tabla a la hora actual, puede omitir el 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'"
```
------
# Restauración de una tabla eliminada con la PITR de Amazon Keyspaces
En el siguiente procedimiento se muestra cómo restaurar una tabla eliminada desde una copia de seguridad al momento de su eliminación. Puede hacerlo mediante CQL o el. AWS CLI
**nota**
En este procedimiento se asume que la PITR estaba habilitado en la tabla eliminada.
------
#### [ Cassandra Query Language (CQL) ]
**Restauración de una tabla eliminada con CQL**
1. Para confirmar que point-in-time la recuperación está habilitada para una tabla eliminada, consulte la tabla del sistema. Solo se muestran las tablas con point-in-time la recuperación habilitada.
```
SELECT custom_properties
FROM system_schema_mcs.tables_history
WHERE keyspace_name = 'mykeyspace' AND table_name = 'my_table';
```
La consulta muestra la siguiente salida.
```
custom_properties
------------------
{
...,
"point_in_time_recovery":{
"restorable_until_time":"2020-08-04T00:48:58.381Z",
"status":"enabled"
}
}
```
1. Restaure la tabla al momento de su eliminación con el siguiente ejemplo de comando.
```
RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable;
```
------
#### [ CLI ]
**Restaure una tabla eliminada mediante AWS CLI**
1. Elimine una tabla que haya creado anteriormente y que tenga la PITR habilitada. El siguiente comando es un ejemplo.
```
aws keyspaces delete-table --keyspace-name 'myKeyspace' --table-name 'myTable'
```
1. Restaure la tabla eliminada al momento de su eliminación con el siguiente comando.
```
aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored2'
```
La salida de este comando devuelve el ARN de la tabla restaurada.
```
{
"restoredTableARN": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/myKeyspace/table/myTable_restored2"
}
```
------