Restaurar una tabla de DynamoDB a partir de un backup - Amazon DynamoDB

Restaurar una tabla de DynamoDB a partir de un backup

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.

Restaurar una tabla a partir de un backup (consola)

En el siguiente procedimiento se muestra cómo restaurar la tabla Music mediante el archivo MusicBackup que se creó en el tutorial Backup 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.

    
                        Captura de pantalla de la lista de backups y del botón para crear un backup.
  4. Seleccione Restore backup (Restaurar backup).

    
                        Captura de pantalla de la lista de backups con el botón para restaurar backups destacado.
  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.

    
                        Captura de pantalla de la opción para restaurar la tabla de la pantalla de backup con los detalles de la tabla de backup.

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

    
                        Captura de pantalla de la lista de tablas con estado activo.

Restaurar una tabla a partir de un backup (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 Backup 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 cifradas 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 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 el backup se ha cifrado mediante una CMK administrada por AWS o una CMK administrada por el cliente, no deshabilite 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.