All Products
Search

This Product

    Data Management:Manually download a backup set

    Document Center

    Data Management:Manually download a backup set

    Last Updated:Oct 18, 2025

    You can manually download a backup set to restore it to an on-premises database, perform analysis and auditing in Excel, or back it up to local storage. This topic describes how to manually download a backup set.

    Limits and format description

    Note

    To ensure a successful download, check the expiration date of the backup set before you start. The download process takes time. If the backup set is about to expire, extend its retention period to prevent it from being automatically deleted during the download. After the download is complete, you can change the retention period back to the original setting. For more information, see Modify the lifecycle of a backup schedule.

    Limitations

    Logical backup

    Physical backup

    Backup destination storage class

    Only DBS Storage is supported. User-owned Object Storage Service (OSS) buckets are not supported.

    Only DBS Storage is supported. User-owned OSS buckets are not supported.

    Full data

    The following database engines are supported:

    • MySQL

    • SQL Server

    • MariaDB

    • PostgreSQL

    • Oracle

    • MongoDB

    Note

    MongoDB data is in the json format. Data from other databases is in the CSV format.

    The following database engines are supported:

    • MySQL

    • SQL Server

    Note

    • MySQL data is compressed and in the format generated by Xtrabackup.

    • SQL Server data is compressed and in the format generated by its native backup command.

    Incremental data

    The following database engine is supported:

    MySQL.

    Note

    Data is in the native MySQL format.

    The following database engines are supported:

    • MySQL

    • SQL Server

    Note

    The data format is the same as the format for full data.

    Pricing

    Downloading backup sets is currently free of charge.

    Procedure

    1. Log on to Data Management (DMS) 5.0.

    2. In the top navigation bar, choose Security and disaster recovery (DBS) > Data Disaster Recovery (DBS) > Backup Plan.

      Note

      If you use the DMS console in simple mode, move the pointer over the 2023-01-28_15-57-17.png icon in the upper-left corner of the DMS console and choose All Features > Security and disaster recovery (DBS) > Data Disaster Recovery (DBS) > Backup Plan.

    3. Find the backup schedule that you want to manage and click the schedule ID or Manage in the Actions column.

      管理按钮

    4. In the navigation pane on the left, choose Backup Tasks > Full Data.

      Note

      • If your database engine supports downloading incremental backup data and you have enabled incremental log backup for the backup instance, you can also download incremental log backup sets.

      • Downloading an Transaction Log Backup set is similar to downloading a Full Data set. To do so, go to Backup Tasks > Transaction Log Backup.

    5. Click Download in the Actions column for the desired Backup Set ID.

    6. In the dialog box that appears, click OK.

      After you click OK, the system packages, compresses, and converts the backup set into a downloadable file. You are then redirected to the Backup Set Download product page.

      Note

      The time required for compression and conversion depends on the size of the backup file. Larger files take longer. For reference, a 150 GB file takes about 4 hours to process.

    7. When the Status of the download task changes to Completed, click Download.

    8. In the panel that appears, select your preferred download method.

      • I see. Downloads: Click this button to start the download in your browser.

      • Copy Public URL

        • Windows

          Open a browser, paste the copied URL in the address bar, and press Enter to download the file.

        • Linux

          Download command: wget "<Copied download link>" -O <Download task ID>.zip

          Example: wget "https://dbs-backup-137***50-cn-hangzhou-ubj5***gisz.oss-cn-hangzhou.aliyuncs.com/shsw*****lIAA%3D" -O vf0x****ilo4.zip

      • Copy Internal URL

        • Windows

          Open a browser, paste the copied URL in the address bar, and press Enter to download the file.

        • Linux

          Download command: wget "<Copied download link>" -O <Download task ID>.zip

          Example: wget "https://dbs-backup-137***50-cn-hangzhou-ubj5***gisz.oss-cn-hangzhou.aliyuncs.com/shsw*****lIAA%3D" -O vf0x****ilo4.zip

    9. (Optional) After the download is complete, follow these steps to decompress the file if needed.

      Downloaded file is in ZIP format

      The decompression command is as follows:

      1. Run the unzip <Download task ID>.zip command.

        If your database contains a large amount of duplicate data or a large volume of data, the error: invalid zip file with overlapped components (possible zip bomb) error may occur during decompression. If this happens, set the UNZIP_DISABLE_ZIPBOMB_DETECTION=TRUE environment variable. For example: UNZIP_DISABLE_ZIPBOMB_DETECTION=TRUE unzip 1iyq***m42.zip.

        Note

        On a Windows operating system, you can decompress the file directly.

      2. Optional: If you obtain a file with the .xb extension after the preceding steps, download the corresponding tool and run the following command to decompress the file.

        To obtain the tool, click xbunpack.exe (for Windows) or xbunpack (for Linux).

        • Windows

          Run the xbunpack.exe -file=<Download task ID>.xb -dir=/<Decompression destination folder> command to obtain the decompressed file.

        • Linux

          Method 1: Run the xbunpack -file=<Download task ID>.xb -dir=/<Decompression destination folder> command to obtain the decompressed file.

          Method 2: Run the cat <Download task ID>.xb | ./xbunpack -dir=/<Decompression destination folder> command to obtain the decompressed file.

          Note

          The xbunpack tool requires executable permissions. You can run the chmod +x xbunpack command to grant the permissions.

      Download file format: tar.gz

      1. Run the gzip -d <Download task ID>.tar.gz command to obtain the <Download task ID>.tar file.

        Note

        On a Windows operating system, you can decompress the file directly.

      2. Run the file <Download task ID>.tar command to check the format of the resulting file:

        • If the file format is POSIX tar archive, run the tar xvf <Download task ID>.tar command to obtain the file.

        • If the file format is Zip archive data, at least v2.0 to extract, run the unzip <Download task ID>.tar command to obtain the file.

        • If the file format is data, run the unzip <Download task ID>.tar command to obtain the <Download task ID> file.

      3. Optional: If you obtain a file with the .xb extension after the preceding steps, download the corresponding tool and run the following command to decompress the file.

        • Windows

          Run the xbunpack.exe -file=<Download task ID>.xb -dir=/<Decompression destination folder> command to obtain the decompressed file.

        • Linux

          Note

          The downloaded xbunpack tool requires executable permissions. You can run the chmod +x xbunpack command to grant the permissions.

          Method 1: Run the ./xbunpack -file=<Download task ID>.xb -dir=/<Decompression destination folder> command to obtain the decompressed file.

          Method 2: Run the cat <Download task ID>.xb | ./xbunpack -dir=/<Decompression destination folder> command to obtain the decompressed file.

        To obtain the tool, click xbunpack.exe (for Windows) or xbunpack (for Linux).

      Downloaded file is in tar.zst format

      • The decompression command is as follows:

        # Decompress <archive_file_name>.tar.zst to <decompression_destination_path>
# zstd: -d=decompress, -c=output to stdout
# tar:  -x=extract, -v=verbose, -f-=read from stdin, -C=specify target directory

zstd -d -c <archive_file_name>.tar.zst | tar -xvf - -C <decompression_destination_path>
        Note

        Windows does not natively support the zstd command-line tool. You can use tools such as 7-Zip with the zstd plugin or PeaZip to decompress the file. To use the command line on other operating systems such as Linux or macOS, install zstd based on your operating system:

        • macOS (using Homebrew): brew install zstd

        • CentOS/RHEL: sudo yum install zstd

        • Ubuntu/Debian: sudo apt install zstd

      • Optional: If you obtain a file with the .xb extension after the preceding steps, download the corresponding tool and run the following command to decompress the file.

        To obtain the tool, click xbunpack.exe (for Windows) or xbunpack (for Linux).

        • Windows

          Run the xbunpack.exe -file=<Download task ID>.xb -dir=/<Decompression destination folder> command to obtain the decompressed file.

        • Linux

          Method 1: Run the xbunpack -file=<Download task ID>.xb -dir=/<Decompression destination folder> command to obtain the decompressed file.

          Method 2: Run the cat <Download task ID>.xb | ./xbunpack -dir=/<Decompression destination folder> command to obtain the decompressed file.

          Note

          The xbunpack tool requires executable permissions. You can run the chmod +x xbunpack command to grant the permissions.