

# Restauración una tabla de DynamoDB a partir de una copia de seguridad
<a name="Restore.Tutorial"></a>

En esta sección se describe cómo restaurar una tabla a partir de un backup mediante la consola de Amazon DynamoDB o mediante la AWS Command Line Interface (AWS CLI). 

**nota**  
Si quiere utilizar la AWS CLI, primero tendrá que configurarla. Para obtener más información, consulte [Acceso a DynamoDB](AccessingDynamoDB.md).

**Topics**

## Restauración de una tabla a partir de una copia de seguridad (consola)
<a name="restoretable_console"></a>

En el siguiente procedimiento se muestra cómo restaurar la tabla `Music` mediante el archivo `MusicBackup` que se creó en el tutorial [Copia de seguridad de una tabla de DynamoDB](Backup.Tutorial.md). 

**nota**  
Este procedimiento asume que la tabla `Music` ya no existe antes de restaurarla utilizando el archivo `MusicBackup`.

**Para restaurar una tabla a partir de una copia de seguridad**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de DynamoDB en [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/).

1. En el panel de navegación del lado izquierdo de la consola, elija **Backups**.

1. En la lista de backups, elija `MusicBackup`.  
![\[Captura de pantalla de la lista de backups y del botón para crear un backup.\]](http://docs.aws.amazon.com/es_es/amazondynamodb/latest/developerguide/images/select_musicbackup.png)

1. Elija **Restore (Restaurar)**.

1. Especifique **Music** como nuevo nombre de tabla. Confirme el nombre del backup y otros detalles del mismo. A continuación, elija **Restore table (Restaurar tabla)** para iniciar el proceso de restauración.
**nota**  
Puede restaurar la tabla a la misma región de AWS o a otra región distinta a donde reside el backup. También puede excluir la creación de los índices secundarios en la nueva tabla restaurada. Además, puede especificar un modo de cifrado diferente.  
Las tablas restauradas a partir de copias de seguridad siempre se crean utilizando la clase de tabla DynamoDB Estándar.  
![\[Captura de pantalla de la opción para restaurar la tabla de la pantalla de backup con los detalles de la tabla de backup.\]](http://docs.aws.amazon.com/es_es/amazondynamodb/latest/developerguide/images/restore_table.png)

   La tabla que se va a restaurar se muestra con el estado **Creating (Creando)**. Una vez finalizado el proceso de restauración, el estado de la tabla `Music` cambia a **Active (Activa)**.

## Restauración de una tabla a partir de una copia de seguridad (AWS CLI)
<a name="restoretable_cli"></a>

Siga estos pasos para utilizar la AWS CLI para restaurar la tabla `Music` mediante la opción `MusicBackup` que se creó en el tutorial [Copia de seguridad de una tabla de DynamoDB](Backup.Tutorial.md).

**Para restaurar una tabla a partir de una copia de seguridad**

1. Confirme el backup que quiere restaurar mediante el comando `list-backups`. En este ejemplo se utiliza `MusicBackup`.

   ```
   aws dynamodb list-backups
   ```

   Para obtener detalles adicionales del backup, use el comando `describe-backup`. Puede obtener la entrada `backup-arn` del paso anterior.

   ```
   aws dynamodb describe-backup \
   --backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01489173575360-b308cd7d
   ```

1. Restaure la tabla a partir del backup. En este caso, `MusicBackup` restaura la tabla `Music` a la misma región de AWS.

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

1. Restaure la tabla desde la copia de seguridad con la configuración de tabla personalizada. En este caso, `MusicBackup` restaura la tabla `Music` y especifica un modo de cifrado para la tabla restaurada.
**nota**  
El parámetro `sse-specification-override` toma los mismos valores que el parámetro `sse-specification-override` utilizado en el comando `CreateTable`. Para obtener más información, consulte [Administración de tablas de cifrado en DynamoDB](encryption.tutorial.md).

   ```
   aws dynamodb restore-table-from-backup \
   --target-table-name Music \
   --backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01581080476474-e177ebe2 \
   --sse-specification-override Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234
   ```

   Puede restaurar la tabla en una región de AWS distinta a aquella en la que reside el backup.
**nota**  
El parámetro `sse-specification-override` es obligatorio para restauraciones entre regiones, pero opcional para restauraciones en la misma región que la tabla de origen.
Al realizar una restauración entre regiones desde la línea de comandos, debe establecer la región de AWS predeterminada en la región de destino deseada. Para obtener más información, consulte [Opciones de línea de comandos](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-options.html) en la *Guía del usuario de AWS Command Line Interface*.

   ```
   aws dynamodb restore-table-from-backup \
   --target-table-name Music \
   --backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01581080476474-e177ebe2 \
   --sse-specification-override Enabled=true,SSEType=KMS
   ```

   Puede reemplazar el modo de facturación y el rendimiento aprovisionado para la tabla restaurada.

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

   Puede excluir la creación de algunos o de todos los índices secundarios en la tabla restaurada.
**nota**  
Las restauraciones pueden ser más rápidas y más económicas si elige excluir la creación de algunos o de todos los índices secundarios en la tabla restaurada.

   ```
   aws dynamodb restore-table-from-backup \
   --target-table-name Music \
   --backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01581081403719-db9c1f91 \
   --global-secondary-index-override '[]' \
   --sse-specification-override Enabled=true,SSEType=KMS
   ```
**nota**  
Los índices secundarios proporcionados deben coincidir con los índices existentes. No puede crear nuevos índices en el momento de la restauración.

   Puede utilizar una combinación de distintas anulaciones. Por ejemplo, puede utilizar un único índice secundario global y cambiar el rendimiento aprovisionado al mismo tiempo, como se indica a continuación.

   ```
   aws dynamodb restore-table-from-backup \
   --target-table-name Music \
   --backup-arn arn:aws:dynamodb:eu-west-1:123456789012:table/Music/backup/01581082594992-303b6239 \
   --billing-mode-override PROVISIONED \
   --provisioned-throughput-override ReadCapacityUnits=100,WriteCapacityUnits=100 \
   --global-secondary-index-override IndexName=singers-index,KeySchema=["{AttributeName=SingerName,KeyType=HASH}"],Projection="{ProjectionType=KEYS_ONLY}",ProvisionedThroughput="{ReadCapacityUnits=5,WriteCapacityUnits=5}" \
   --sse-specification-override Enabled=true,SSEType=KMS
   ```

 Para comprobar la restauración, use el comando `describe-table` para describir la tabla `Music`.

```
aws dynamodb describe-table --table-name Music 
```

La tabla que se va a restaurar a partir del backup se muestra con el estado **Creating (Creando)**. Una vez finalizado el proceso de restauración, el estado de la tabla `Music` cambia a **Active (Activa)**.

**importante**  
Mientras la restauración esté en curso, no modifique ni elimine su política de roles de IAM, ya que podría conllevar comportamientos inesperados. Por ejemplo, suponga que eliminó los permisos de escritura de una tabla mientras esta se restauraba. En ese caso, la operación subyacente `RestoreTableFromBackup` no puede escribir ninguno de los datos restaurados en la tabla.  
Después de que se complete la operación de restauración, puede modificar o eliminar su política de roles de IAM.  
Políticas de IAM que implican [restricciones de la IP de origen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceip) para acceder a la tabla de restauración de destino debe tener el conjunto de clave [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-viaawsservice](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-viaawsservice)establecida en `false` para asegurar que las restricciones se apliquen únicamente a las solicitudes presentadas directamente por un principal. De lo contrario, la restauración se cancelará.  
Si la copia de seguridad está cifrada con una Clave administrada de AWS o una clave administrada por el cliente, no desactive ni elimine la clave mientras haya una restauración en curso, pues si lo hace la restauración no se realizará correctamente.  
Una vez finalizada la operación de restauración, puede cambiar la clave de cifrado de la tabla restaurada y deshabilitar o eliminar la clave anterior.