Skip to content

Commit e9a4dd1

Browse files
ti-chi-botYuJuncenlilin90github-actions[bot]hfxsd
authored
v8.5.5 br: add compatibility between log backup and PITR (#20485) (#22168)
* added translation (by Claude 3.7 Sonnet Thinking) * tweaking some terms * Refine wording and format Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update wording * Update br/br-pitr-manual.md Co-authored-by: xixirangrang <[email protected]> * Update version wording Co-authored-by: Grace Cai <[email protected]> --------- Co-authored-by: hillium <[email protected]> Co-authored-by: Lilian Lee <[email protected]> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: xixirangrang <[email protected]> Co-authored-by: Grace Cai <[email protected]>
1 parent dd0fb09 commit e9a4dd1

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

br/br-pitr-manual.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -498,3 +498,25 @@ tiup br restore point --pd="${PD_IP}:2379"
498498
--master-key-crypter-method aes128-ctr
499499
--master-key "local:///path/to/master.key"
500500
```
501+
502+
### Compatibility between ongoing log backup and snapshot restore
503+
504+
Starting from v8.5.5, when a log backup task is running, if all of the following conditions are met, you can still perform snapshot restore (`br restore [full|database|table]`) and allow the restored data to be properly recorded by the ongoing log backup (hereinafter referred to as "log backup"):
505+
506+
- The node performing backup and restore operations has the following necessary permissions:
507+
- Read access to the external storage containing the backup source, for snapshot restore
508+
- Write access to the target external storage used by the log backup
509+
- The target external storage for the log backup is Amazon S3 (`s3://`), Google Cloud Storage (`gcs://`), or Azure Blob Storage (`azblob://`).
510+
- The data to be restored uses the same type of external storage as the target storage for the log backup.
511+
- Neither the data to be restored nor the log backup has local encryption enabled. For details, see [log backup encryption](#encrypt-the-log-backup-data) and [snapshot backup encryption](/br/br-snapshot-manual.md#encrypt-the-backup-data).
512+
513+
If any of the above conditions are not met, or if you need to perform a point-in-time recovery, while a log backup task is running, BR refuses to proceed with the data recovery. In this case, you can complete the recovery by following these steps:
514+
515+
1. [Stop the log backup task](#stop-a-log-backup-task).
516+
2. Perform the data restore.
517+
3. After the restore is complete, perform a new snapshot backup.
518+
4. [Restart the log backup task](#restart-a-log-backup-task).
519+
520+
> **Note:**
521+
>
522+
> When restoring a log backup that contains records of snapshot (full) restore data, you must use BR v8.5.5 or later. Otherwise, restoring the recorded full restore data might fail.

0 commit comments

Comments
 (0)