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

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.

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 la interfaz de línea de comandos de AWS (CLI de AWS).

nota

Si quiere utilizar la CLI de AWS, 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 Hacer copias 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 consola de administración de AWS y abra la consola de DynamoDB enhttps://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 la copia de seguridad. 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 (CLI de AWS)

Siga estos pasos para utilizar la CLI de AWS para restaurar laMusiccon la tabla deMusicBackupque se crea en elHacer copias de seguridad de una tabla de DynamoDB"Hello, World!"

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 la copia de seguridad.

    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, consulteOpciones de la línea de comandosen laGuía del usuario de la línea de comandos de AWS.

    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 implicanRestricciones IP de origenpara acceder a la tabla de restauración de destino debe tener elaws:ViaAWSServiceestablecida enfalsePara garantizar 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 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.