Restoring a Container to the Same Account for Azure Cosmos DB

Updated

On this page

You can restore Azure Cosmos DB database containers to the same or a different Cosmos DB account on the same Azure subscription. You can also restore the database and containers with the same name or a different name.

Procedure

  1. From the navigation page, click Protect> Databases >Cosmos DB instance.

  2. In the Backup History section, select a date that contains a backup, and then click Restore.

    Dates with a grey circle indicate that a backup exists for that day. You can also select the time range or a specific time of the backup.

    The Backup content page appears.

  3. Select the backups to restore.

    • To use the latest backup, in the upper-right corner of the page, click Show latest backups.

    • To use a backup from a specific date, in the upper-right corner of the page, click Show backups as of a specific date, and then select the backup.

    • To use a backup from a specific date range, in the upper-right corner of the page, click Show backup for a date range, and then select the backup.

  4. Select the data that you want to restore

    • To restore all of the data, select the check box next to instance name.

    • To restore individual containers, click the instance name > database name, and then select the check box next to each container that you want to restore.

  5. Click Restore.

    The Restore options page appears.

  6. To redirect the selected containers to a different Cosmos DB account in Azure, move the Redirect all containers toggle key to the right, and then select a destination Cosmos DB account.

  7. Optional: To increase the throughput of the container and increase the restore performance, move the Adjust write throughput toggle to the right, and then select the number of Request Units (RUs).

    Notes:

    • The software will increase the throughput or Request Units (RUs) of the container, only if the given value is higher than the original throughput of the container at the time of backup.

    • If the containers have autoscaling enabled, the software will increase the throughput during the restore, only if the given value is more than the maximum Request Units (RUs).

    • If you want to restore containers that had shared throughput during the backup, do not enable the Adjust write throughput setting for the restore. For more information on shared throughput, refer to Microsoft article (https://docs.microsoft.com/en-us/azure/cosmos-db/set-throughput#set-throughput-on-a-database).

  8. In the Number of parallel writers box, type the number of streams to be used by the restore operation.

  9. If you want to restore containers that already exist on the destination, move the Overwrite destination containers toggle key to the right.

    If you do not enable this option and a container already exists on the destination, the restore jobs may fail.

  10. To restore a container with a different name, under Content, in the Actions column, click the Edit icon for the container that you want to change the name.

  11. The Edit dialog box appears.

  12. To change the database name, in the Destination database box, type a new name.

  13. To change the container name, in the Destination container box, type a new name.

  14. Click Submit.