Restauración una tabla de DynamoDB a partir de una copia de seguridad

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.

Restauración de una tabla a partir de una copia de seguridad (consola)

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.

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 AWS Management Console y abra la consola de DynamoDB en https://console.aws.amazon.com/dynamodb/.

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

3. En la lista de backups, elija MusicBackup.

   

4. Elija Restore (Restaurar).

5. 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.

   

   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)

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.

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 

2. 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 

3. 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.

   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 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 para acceder a la tabla de restauración de destino debe tener el conjunto de clave aws:ViaAWSServiceestablecida 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.