Skip to content
Open
Changes from all commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
dbdb691
add restore from s3/oss
wildpcww Dec 19, 2025
0e7e99e
Update tidb-cloud/premium/backup-and-restore-premium.md
wildpcww Dec 19, 2025
ccf92e7
Apply suggestions from code review
hfxsd Dec 19, 2025
b4d0f9a
Apply suggestions from code review
hfxsd Dec 19, 2025
1862cca
Update backup-and-restore-premium.md
hfxsd Dec 22, 2025
a7e98f0
Update backup restore and instance creation steps
hfxsd Dec 22, 2025
9dbf2af
Update backup-and-restore-premium.md
hfxsd Dec 22, 2025
8a78915
Update backup-and-restore-premium.md
hfxsd Dec 22, 2025
4abb72f
Update backup-and-restore-premium.md
hfxsd Dec 22, 2025
fd5fb3b
Update backup-and-restore-premium.md
hfxsd Dec 22, 2025
3adebbb
Refactor limitations and prerequisites in restore guide
hfxsd Dec 22, 2025
1248d02
Apply suggestions from code review
hfxsd Dec 22, 2025
97e95ab
Update serverless-high-availability.md
hfxsd Dec 22, 2025
c539192
Update high availability references to include Premium
hfxsd Dec 22, 2025
34d8259
Update serverless-high-availability.md
hfxsd Dec 22, 2025
6ff8e53
Update high availability documentation links and notes
hfxsd Dec 22, 2025
56a8077
Apply suggestions from code review
hfxsd Dec 22, 2025
ba00105
Update backup-and-restore-premium.md
hfxsd Dec 23, 2025
9887ef0
Update backup-and-restore-premium.md
hfxsd Dec 23, 2025
2d2636d
Update backup-and-restore-premium.md
wildpcww Dec 24, 2025
4ac3a13
Apply suggestions from code review
hfxsd Dec 24, 2025
2734b54
Merge branch 'release-8.5' into pr/22227
hfxsd Dec 24, 2025
abc7965
Apply suggestions from code review
hfxsd Dec 24, 2025
6a31fdc
Update tidb-cloud/premium/backup-and-restore-premium.md
hfxsd Dec 24, 2025
82d7a9c
Apply suggestions from code review
hfxsd Dec 24, 2025
9fa36dd
Update tidb-cloud/premium/backup-and-restore-premium.md
hfxsd Dec 24, 2025
9b49cab
Apply suggestions from code review
hfxsd Dec 25, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 23 additions & 33 deletions tidb-cloud/premium/backup-and-restore-premium.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,49 +30,39 @@ Backup files can originate from the following sources:

## Automatic backups

TiDB Cloud automatically backs up your instance data, letting you restore data from a backup snapshot to minimize data loss in the event of a disaster.
{{{ .premium }}} offers enhanced automatic backup capabilities, combining high-frequency snapshots with log backups to maximize data reliability for production environments.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
{{{ .premium }}} offers enhanced automatic backup capabilities, combining high-frequency snapshots with log backups to maximize data reliability for production environments.
{{{ .premium }}} provides enhanced automatic backup capabilities for production environments. It combines high-frequency snapshots with log backups to ensure data reliability.


### Learn about the backup setting
### Automatic backup policies

Compared with {{{ .starter }}} clusters and {{{ .essential }}} clusters, {{{ .premium }}} offers enhanced backup capabilities, including longer retention and hourly backup support.
{{{ .premium }}} instances provide a comprehensive data protection strategy through a multi-layered backup architecture:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
{{{ .premium }}} instances provide a comprehensive data protection strategy through a multi-layered backup architecture:
{{{ .premium }}} instances use a multi-layer backup architecture to protect your data, as described in the following table:


| Backup setting | {{{ .starter }}} (free) | {{{ .starter }}} (with spending limit > 0) | {{{ .essential }}} | {{{ .premium }}} |
|------------------|--------------------------|---------------------------------------------|--------------------|------------------|
| Backup Cycle | Daily | Daily | Daily | Daily + Hourly |
| Backup Retention | 1 day | 30 days | 30 days | Up to 33 days |
| Backup Time | Fixed time | Configurable | Configurable | Configurable |
- Point-in-Time Recovery (PITR)
- Retention period: 7 days.
Comment on lines +39 to +40
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Point-in-Time Recovery (PITR)
- Retention period: 7 days.
| Backup type | Retention period | Restore granularity |
| --- | --- | --- |
| **Point-in-time recovery (PITR)** | 7 days | Restore to any specific point in time within the 7-day window. |
| **Hourly snapshot** | 7 days | Restore from any hourly snapshot generated within the last 7 days. |
| **Daily snapshot** | 33 days | Restore from any daily snapshot generated within the last 33 days. By default, daily snapshots are captured at 00:00 UTC. |

Replcae L39-49 with a table with a table to make it easier to compare backup type.

- Restore granularity: supports restoration to any specific moment within the 7-day retention window.

- **Backup Cycle** determines how frequently backups are created.
- Hourly backup snapshot
- Retention period: 7 days.
- Restore granularity: supports restoration to any specific hourly snapshot generated within the 7-day retention window

- Premium instances support both **daily** and **hourly** backups.
- The **default** is **hourly backups**.
- Daily backup snapshot
- Retention period: 33 days.
- Restore granularity: supports restoration to any daily snapshot (captured at 0:00 UTC by default) within the 33-day retention window.

- **Backup Retention** is the duration for which backups are retained. Expired backups cannot be restored.
### Backup execution rules

- Premium instances can retain backups for up to **33 days**.
- Backup cycle: {{{ .premium }}} instances support both daily and hourly automatic backups.
Copy link
Collaborator

@Oreoxmt Oreoxmt Dec 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Backup cycle: {{{ .premium }}} instances support both daily and hourly automatic backups.
- **Backup cycle**: {{{ .premium }}} instances perform both hourly and daily automatic backups.


- **Backup Time** is the scheduled start time for backups.
- Backup schedule:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Backup schedule:
- **Backup schedule**:

- Hourly backup: always runs at the start of every hour (on the hour).
- Daily backup: executed daily at 0:00 UTC.
- Currently, backup time management or customization is not supported.
Comment on lines +56 to +58
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Hourly backup: always runs at the start of every hour (on the hour).
- Daily backup: executed daily at 0:00 UTC.
- Currently, backup time management or customization is not supported.
- Hourly backups run at the start of every hour.
- Daily backups run at 00:00 UTC each day.
- Currently, you cannot customize or manage backup schedules.


- For Premium instances, **daily backups** can be configured to start at a preferred time (in 30-minute intervals), while **hourly backups** always run on the hour.
- **Retention mechanism**: backups that exceed their retention period (7 days or 33 days) automatically expire and cannot be restored.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Retention mechanism**: backups that exceed their retention period (7 days or 33 days) automatically expire and cannot be restored.
- **Retention behavior**: backups expire automatically when they exceed their retention period (7 days or 33 days) and cannot be restored.


### Configure the backup settings

To configure backups for a {{{ .premium }}} instance, perform the following steps:

1. Navigate to the [**Backup**](#view-the-backup-page) page of your TiDB instance.

2. Click **Backup Setting**. This will open the **Backup Setting** window, where you can configure automatic backup options.

3. In **Backup Cycle**, choose between the **Hourly Backup** and **Daily Backup** tabs:

- **Hourly Backup** (default):
- Runs **on the hour**.
- You can configure **Backup Retention** (1–33 days).
- **Daily Backup**:
- Runs at a configurable time in **30-minute intervals**.
- You can configure both **Backup Retention** (1–33 days) and **Backup Time**.

4. Click **Save** to save your settings.
> **Note:**
>
> - Storage costs for automatic backups are calculated based on your backup data volume and retention duration.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> - Storage costs for automatic backups are calculated based on your backup data volume and retention duration.
> - Automatic backup storage costs depend on the backup data volume and the retention period.

> - To extend a backup retention period beyond the default limits, contact [TiDB Cloud Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support).
Copy link
Collaborator

@Oreoxmt Oreoxmt Dec 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> - To extend a backup retention period beyond the default limits, contact [TiDB Cloud Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support).
> - To extend the backup retention period beyond the default limits, contact [TiDB Cloud Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support).


### Delete backup files

Expand Down