All Products
Search
Document Center

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

Last Updated:Nov 26, 2025

The database and table restoration feature restores only specified databases or tables to the original cluster. For example, in the gaming industry, you can use this feature to restore data for only one or more players. You can restore databases and tables from a backup set or to a point in time. This topic describes how to restore specified databases or tables from a backup set.

Introduction

PolarDB provides a database and table restoration feature that creates new databases and tables in the original cluster. This feature does not overwrite, delete, or write data to existing databases and tables. During the restoration process, you can specify new names for the databases or tables. For example, you can restore backup data from db1 to a new database named db2.

The restoration process does not affect normal access to the original cluster. However, it may consume computing resources and increase the CPU utilization and input/output operations per second (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

  • You can use the database and table restoration feature even if a cluster contains more than 50,000 tables, including system tables.

    Note
    • This feature is currently in canary release. To use this feature, you can contact us to be added to the whitelist.

    • To query the number of tables, including system tables, in a cluster, execute the following SQL statement:

      SELECT COUNT(*) FROM information_schema.tables;
    • To query the number of system tables in a cluster, execute the following SQL statement:

      SELECT COUNT(*) FROM information_schema.tables WHERE table_schema IN ('sys', 'performance_schema', 'mysql', 'information_schema', '__recycle_bin__');
  • The database and table restoration feature does not restore triggers. If an original table has a trigger, the trigger is not restored.

  • The database and table restoration feature does not restore foreign keys. If an original table has a foreign key, the foreign key is not restored.

Procedure

  1. Log on to the PolarDB console. In the navigation pane on the left, click Clusters. Select the region where the cluster is deployed. Find the target cluster and click its ID.

  2. In the navigation pane on the left, choose Settings and Management > Backup and Restoration. Click Restore Databases/Tables.

  3. In the dialog box that appears, set Restoration Type to Backup Set and select a backup set.image

    Note

    The database and table restoration feature provides three configurations based on IOPS consumption: Quick, Regular, and Secure. You can select a configuration based on your actual requirements. For the estimated restoration duration of each configuration, see Database and table restoration speed test data reference.

    • Quick: Consumes many IOPS (about 60%). Select this option during off-peak hours.

    • Regular (Recommended): Consumes a moderate number of IOPS (about 30%).

    • Secure: Consumes a small number of IOPS (about 15%). This may significantly slow down the restoration.

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

    1

    Note
    • If you do not specify new names, the system automatically creates names by adding the _backup suffix to the original names. For example, if the original table is named test, the new table is named test_backup.

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

  5. After you confirm the selected databases and tables, click OK.

Related API operations

API

Description

DescribeMetaList - Query the details of databases and tables that can be restored

Call the DescribeMetaList operation to view the metadata details of databases and tables that can be restored.

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

Call the RestoreTable operation to restore databases and tables of a PolarDB cluster.