Restoring Database from Physical Backup File

Last updated: 2020-04-01 16:46:06


Operation Scenarios

The open-source software tool Percona Xtrabackup can be used to back up and restore databases. This document describes how to use XtraBackup to restore a logical backup file of a TencentDB for MySQL instance to a self-built database on another server.

XtraBackup only supports Linux but not Windows.


  • Download and install XtraBackup.
    XtraBackup can be downloaded at Percona's official website. Please select Percona XtraBackup 2.4.6 or higher. For more information on how to install the tool, please see Percona XtraBackup 2.4.
  • Supported instance version: TencentDB for MySQL 5.5, 5.6, and 5.7 High-Availability Edition.


Step 1. Download the backup file

  1. Log in to the TencentDB for MySQL Console. In the instance list, click an instance name or Manage in the "Operation" column to enter the instance management page.
  2. On the instance management page, click Backup and Restore > Data Backup List, select the backup to download, and then click Download in the "Operation" column.
  3. You are recommended to copy the download address in the pop-up dialog box, log in to a (Linux) CVM instance in the same VPC as the TencentDB instance, and run the wget command for download over the private network at a higher speed.
    • You can also select Local Download to download it directly, which takes more time though.
    • wget command format: wget -c 'backup file download address' -O custom filename.xb
    Below is a sample:
    wget -c '' -O test0.xb

Step 2. Unpack the backup file

Unpack the backup file with xbstream.

xbstream -x < test0.xb
  • Replace test0.xb with your backup file.

The unpacking result is as shown below:

Step 3. Decompress the backup file

  1. Download qpress by running the following command.

    If an error is displayed for the wget download operation, you can go to QuickLZ's official website to download the qpress locally, and then upload it to the Linux CVM instance. For more information, please see Uploading Files to Linux CVM with SCP.

  2. Extract the qpress binary files by running the following command.
    tar -xf qpress-11-linux-x64.tar -C /usr/local/bin
    source /etc/profile
  3. Decompress the backup file with qpress.
    qpress -d cdb-jp0zua5k_backup_20191202182218.sql.qp .

    Find the backup file with .sql.qp extension by decompression time and replace cdb-jp0zua5k_backup_20191202182218 with its filename.

    The decompressing result is as shown below:

Step 4. Import into the database

Import the file into the database by running the following command:

mysql -uroot -P3306 -h127.0.0.1 -p < cdb-jp0zua5k_backup_20191202182218.sql
  • Importing into a local MySQL instance with port 3306 is used as an example in this document. You can replace it according to the actual situation.
  • Replace cdb-jp0zua5k_backup_20191202182218.sql with the .sql file actually extracted by qpress.