Get Started with Recovery Groups
This document describes how to create a recovery group to protect your databases running on TiDB Cloud Dedicated clusters using the TiDB Cloud console. It also shows how to view details of a recovery group.
Prerequisites
- A recovery group replicates your databases to another cluster to protect your databases from regional disasters. Before creating a recovery group, you need to have two TiDB Cloud Dedicated clusters. One cluster hosts the primary databases, and a second cluster hosts the replicas of the primary databases. If you have not done so already, follow the steps in Create a TiDB Dedicated Cluster to create the necessary clusters.
- To create a recovery group, you must be in the
Organization Owner
role of your organization or theProject Owner
role of the target project.
Create a new recovery group
To create a recovery group, perform the following steps:
In the TiDB Cloud console, click in the lower-left corner, switch to the target project if you have multiple projects, and then click Project Settings.
In the Project Settings navigation pane, click Recovery Group.
On the Recovery Group page, click Create Recovery Group.
On the Create Recovery Group page, enter a name for the recovery group.
Select the TiDB Dedicated cluster that will be the primary cluster for this group.
Select the TiDB Dedicated cluster that will be the secondary cluster where databases will be replicated for this group.
Select which databases you wish to replicate as part of this recovery group.
Review the summary information, and then click Create to begin protecting the databases as part of the new recovery group.
View recovery group details
After creating a recovery group, you can view its status information on the Recovery Group Detail page:
In the TiDB Cloud console, click in the lower-left corner, switch to the target project if you have multiple projects, and then click Project Settings.
In the Project Settings navigation pane, click Recovery Group.
On the Recovery Group page, click the name of the recovery group that you wish to view.
The Recovery Group Detail page provides information about a recovery group, including its configuration details, status, and metrics on the replication throughput and latency.
When a replication relationship is fully established and functioning, the status is displayed as Available.
About resiliency levels
A resiliency level defines the consistency characteristics of data reading in different scenarios of a recovery group. Currently, TiDB Cloud only provides the following resiliency level:
- No consistency guaranteed. During the replication of a recovery group, the downstream cluster does not guarantee transaction consistency read. When the upstream cluster becomes unavailable, you can not restore the data in the downstream cluster to a transaction consistency state.
TiDB Cloud will provide two additional resiliency levels in the near future:
- Eventual consistency. During the replication of a recovery group, the downstream cluster does not guarantee transaction consistency read. However, when the upstream cluster becomes unavailable, you can restore the data in the downstream cluster to a transaction consistency state.
- Near real-time consistency. During the replication of a recovery group, the downstream cluster provides approximately real-time transaction consistency read. When the upstream cluster becomes unavailable, you can restore the data in the downstream cluster to a transaction consistency state.
What's next
After creating the recovery group, you might want to familiarize yourself with the failover and reprotect operations. These operations are used to Failover the primary cluster for the replicated databases from one cluster to the other, and then to later re-establish replication in the opposite direction to Reprotect the failed over databases.