All Products
Search
Document Center

PolarDB:Method 1 for database and table restoration: Restore data from a backup set

Last Updated:Jul 31, 2026

Database and table restoration restores only specified databases or tables to the original cluster. For example, in gaming scenarios, you may need to restore only the data of specific players. In such cases, you can use the database and table restoration feature. Database and table restoration supports two backup methods: restoration from a backup set and restoration to a past point in time. This topic describes how to restore specified databases or tables from a backup set.

Introduction

The database and table restoration feature provided by PolarDB does not overwrite or delete existing databases and tables in the original cluster, nor does it write data into existing databases and tables. Instead, it creates new databases and tables in the original cluster. During database and table restoration, you can specify new database names or table names to restore the backup data of db1 to db2.

During database and table restoration, normal access to the databases in the original cluster is not affected. However, the restoration may consume computing resources of the original cluster, which can cause an increase in CPU utilization and IOPS of the cluster.

Scenarios

Cluster editions

The database and table restoration feature supports PolarDB Enterprise Edition and Standard Edition, but requires specific cluster revision versions. The following table lists the minimum revision versions required for different scenarios.

  • Basic Features: The minimum revision version required to support database and table restoration.

  • GDN primary cluster/New restoration process: The minimum revision version required to use the feature on a global database network (GDN) primary cluster or to benefit from the speed optimization of the new restoration process.

    Note

    The new restoration flow for the database and table restoration feature is an enhancement that optimizes the speed of restoring data to the original cluster. For more information about the mechanism and speed, see Overall Flow and Estimated Time.

Edition Series

MySQL Version

Architecture

Basic Features (Minimum Revision Version)

GDN Primary Cluster/New Restoration Process (Minimum Revision Version)

Enterprise Edition (Cluster Edition)

5.6

X86

5.6.1.0.25

5.6.1.0.42

5.7

X86

5.7.1.0.8

5.7.1.0.36

8.0.1

X86

8.0.1.1.14

8.0.1.1.46

8.0.2

X86

8.0.2.2.0

8.0.2.2.26

Standard Edition

5.6

X86

5.6.1.0.42

5.6.1.0.42

5.7

X86

5.7.1.0.30

5.7.1.0.30

8.0.1

X86

8.0.1.1.38.2

8.0.1.1.38.2

Yitian (ARM)

8.0.1.1.41

8.0.1.1.41

8.0.2

X86

8.0.2.2.21

8.0.2.2.21

Note

You can view the kernel version of your cluster in the Configuration Information section on the Basic Information page of your PolarDB for MySQL cluster.

Other limitations

The database and table restoration feature has the following limitations:

  • Clusters:

    • The feature is not supported for Multi-master Cluster (Limitless) Edition clusters or secondary clusters in a global database network (GDN).

    • Database and table restoration is not supported for clusters with more than 50,000 tables in either of the following cases:

      • The storage type is enterprise SSD (ESSD).

      • The cluster has no read-only (RO) nodes.

  • Table schemas and indexes:

  • Storage engines: Only tables that use the InnoDB storage engine can be restored.

  • Data status: Tables that are archived as cold data cannot be restored.

Note

If your current cluster does not support the database and table restoration feature, you can use full restoration to restore data to a new cluster, and then migrate the data to the source cluster.

Usage notes

  • Restoration from a backup set in the database and table restoration feature only supports restoration from first-level backup sets. Restoration from second-level backup sets is not supported.

  • When you perform database and table restoration, if the specified database name or table name already exists in the original cluster, the restoration fails.

  • Database and table restoration restores only specified tables. Make sure that you have selected all the tables that need to be restored.

    Note

    If you cannot determine all the tables involved, we recommend that you restore the historical data of the entire cluster to a new cluster and then migrate the data to the original cluster. For more information, see Restore from a backup set and Restore a cluster to a point in time.

  • If you do not restore the entire database, up to 100 tables can be restored at a time for each database. If you restore the entire database, all tables in the database are restored.

    Note
    • If too many tables are restored at a time, the restoration takes a long time. Therefore, we recommend that you do not restore too many tables at a time.

    • If you need to restore a large number of tables, we recommend that you restore the full historical data to a new cluster. For detailed operation steps, see Restore from a backup set and Restore a cluster to a point in time.

  • You can use the database and table restoration feature even when the cluster has more than 50,000 tables (including system tables).

    Note
    • This feature is currently in the phased rollout stage. To use this feature, you can Contact us to add the cluster to the whitelist and enable this feature.

    • Query the number of tables (including system tables) in the cluster. The SQL statement is as follows:

      SELECT COUNT(*) FROM information_schema.tables;
    • Query the number of system tables in the cluster. The SQL statement is as follows:

      SELECT COUNT(*) FROM information_schema.tables WHERE table_schema IN ('sys', 'performance_schema', 'mysql', 'information_schema', '__recycle_bin__');
  • Database and table restoration does not support restoring triggers. If the original table has a trigger configured, the trigger is not restored.

  • Database and table restoration does not support restoring foreign keys. If the original table has a foreign key configured, the foreign key is not restored.

  • We recommend that you perform data restoration during off-peak hours.

Procedure

  1. Log in to the PolarDB console,In the navigation pane on the left, click Clusters. Select the Region where the cluster is deployed, and then click the cluster ID to go to the cluster details page。

  2. In the left-side navigation pane, choose Settings and Management > Backup and Restoration and click Restore Databases/Tables.

  3. In the dialog box that appears, set Restoration Type to Backup Set, and select the destination backup set from the backup set list.

    Note

    The database and table restoration feature provides three speed configurations based on IOPS consumption: Quick, Standard, and Secure. Select a configuration based on your business requirements. For the estimated restoration duration of each speed configuration, see Reference for database and table restoration speed tests.

    • Quick: When data is being restored to the current cluster, a large amount of IOPS may be consumed. We recommend that you select this configuration during off-peak hours.

    • Standard (recommended for clusters with more than 4 cores): When data is being restored to the current cluster, a moderate amount of IOPS may be consumed.

    • Secure (recommended for clusters with 4 cores or fewer): When data is being restored to the current cluster, only a small amount of IOPS is consumed, but the restoration speed may be significantly affected.

    For clusters with 4 cores or fewer, we recommend that you verify that innodb_io_capacity and innodb_io_capacity_max are set to values that match the cluster specification. For the maximum supported IOPS of each cluster specification, see Compute node specifications for Enterprise Edition and Compute node specifications for Standard Edition. We recommend that you use the Secure speed for restoration.

  4. In the Databases and Tables to Restore section, select the destination database on the left side and the destination tables on the right side.

    Note
    • If you do not specify new database names or table names, the system appends _backup to the original database names or table names to automatically generate new database names and table names. For example, if the original table name is test, the automatically generated new table name is test_backup.

    • If you select a destination database but do not specify tables, all tables in the database are restored by default.

  5. After confirming that you have selected the databases and tables that you want to restore, click OK.

API reference

Operation

Description

DescribeMetaList

Queries the metadata details of databases and tables that can be restored.

Restore specified databases or tables of a PolarDB cluster to the original cluster

Restores specified databases or tables of a PolarDB cluster to the original cluster.