From 02322923060a8165b3989a531a3f0b7966756032 Mon Sep 17 00:00:00 2001 From: Yu Juncen Date: Thu, 6 Mar 2025 16:20:34 +0800 Subject: [PATCH 1/8] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=97=A5=E5=BF=97?= =?UTF-8?q?=E5=A4=87=E4=BB=BD=E4=B8=8E=E6=81=A2=E5=A4=8D=E4=B9=8B=E5=85=BC?= =?UTF-8?q?=E5=AE=B9=E6=80=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- br/br-pitr-manual.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index aa36fc257a1e..2e395e07d83d 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -492,4 +492,19 @@ tiup br restore point --pd="${PD_IP}:2379" --crypter.key 0123456789abcdef0123456789abcdef --master-key-crypter-method aes128-ctr --master-key "local:///path/to/master.key" -``` \ No newline at end of file +``` + +### 进行中日志备份与恢复的兼容性 从 v9.0.0 版本开始引入 + +自 v9.0.0 开始，在日志备份任务存在的时候，若满足如下条件，可以正常进行快照恢复(`br restore [full|database|table]`)并且恢复的内容可以正常被进行中的日志备份（下称“日志备份”）记录： + +- 执行 BR 的节点具有写入日志备份目标外部存储的权限。 +- 日志备份的目标外部存储类型是 S3(`s3://`), GCS(`gcs://`) 或者 Azure Blob Storage(`azblob://`)。 +- 待恢复的数据与日志备份的目标存储拥有相同的外部存储类型。 +- 待恢复的数据和日志备份均未开启本地加密：参考[日志备份加密](#加密日志备份数据)，[快照备份加密](/br/br-snapshot-manual.md#备份数据加密)。 + +如果不满足上述条件或者欲要恢复到时间点，在日志备份任务存在时，BR 会拒绝恢复。此时你可以通过[停止备份任务](#停止日志备份任务)并在恢复完成后重新进行快照备份并[重新启动备份任务](#重新启动备份任务)来完成恢复。 + +> **注意：** +> +> 恢复记录了全量恢复的日志备份的时候，也需要使用大于 `v9.0.0` 版本的 BR。 否则可能导致记录下来的全量恢复无法被恢复。 \ No newline at end of file From 28e3c579d3704c737fc269ccefb741106d90bb60 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B1=B1=E5=B2=9A?= <36239017+YuJuncen@users.noreply.github.com> Date: Thu, 6 Mar 2025 18:13:59 +0800 Subject: [PATCH 2/8] Update br/br-pitr-manual.md Co-authored-by: BornChanger <97348524+BornChanger@users.noreply.github.com> --- br/br-pitr-manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index 2e395e07d83d..fa5ea09f1d89 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -498,7 +498,7 @@ tiup br restore point --pd="${PD_IP}:2379" 自 v9.0.0 开始，在日志备份任务存在的时候，若满足如下条件，可以正常进行快照恢复(`br restore [full|database|table]`)并且恢复的内容可以正常被进行中的日志备份（下称“日志备份”）记录： -- 执行 BR 的节点具有写入日志备份目标外部存储的权限。 +- 执行 BR 的节点除了执行快照恢复需要的对备份来源外部存储的权限之外，还需要具有写入日志备份目标外部存储的权限。 - 日志备份的目标外部存储类型是 S3(`s3://`), GCS(`gcs://`) 或者 Azure Blob Storage(`azblob://`)。 - 待恢复的数据与日志备份的目标存储拥有相同的外部存储类型。 - 待恢复的数据和日志备份均未开启本地加密：参考[日志备份加密](#加密日志备份数据)，[快照备份加密](/br/br-snapshot-manual.md#备份数据加密)。 From b62eed09048a6d6bbec92346ad5362740ce6e55e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B1=B1=E5=B2=9A?= <36239017+YuJuncen@users.noreply.github.com> Date: Thu, 13 Mar 2025 17:00:48 +0800 Subject: [PATCH 3/8] Apply suggestions from code review Co-authored-by: Lilian Lee --- br/br-pitr-manual.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index fa5ea09f1d89..af2bcfa8defe 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -496,15 +496,15 @@ tiup br restore point --pd="${PD_IP}:2379" ### 进行中日志备份与恢复的兼容性 从 v9.0.0 版本开始引入 -自 v9.0.0 开始，在日志备份任务存在的时候，若满足如下条件，可以正常进行快照恢复(`br restore [full|database|table]`)并且恢复的内容可以正常被进行中的日志备份（下称“日志备份”）记录： +从 v9.0.0 开始，当存在日志备份任务时，如果**同时满足**以下条件，则可以正常进行快照恢复 (`br restore [full|database|table]`) 并且恢复的数据可以被进行中的日志备份（下称“日志备份”）正常记录： -- 执行 BR 的节点除了执行快照恢复需要的对备份来源外部存储的权限之外，还需要具有写入日志备份目标外部存储的权限。 -- 日志备份的目标外部存储类型是 S3(`s3://`), GCS(`gcs://`) 或者 Azure Blob Storage(`azblob://`)。 +- 对于执行备份恢复操作的节点，除了有执行快照恢复需要的对备份来源外部存储的权限之外，还需要具有写入日志备份目标外部存储的权限。 +- 日志备份的目标外部存储类型是 S3 (`s3://`)、GCS (`gcs://`) 或 Azure Blob Storage (`azblob://`)。 - 待恢复的数据与日志备份的目标存储拥有相同的外部存储类型。 -- 待恢复的数据和日志备份均未开启本地加密：参考[日志备份加密](#加密日志备份数据)，[快照备份加密](/br/br-snapshot-manual.md#备份数据加密)。 +- 待恢复的数据和日志备份均未开启本地加密，参考[日志备份加密](#加密日志备份数据)和[快照备份加密](/br/br-snapshot-manual.md#备份数据加密)。 -如果不满足上述条件或者欲要恢复到时间点，在日志备份任务存在时，BR 会拒绝恢复。此时你可以通过[停止备份任务](#停止日志备份任务)并在恢复完成后重新进行快照备份并[重新启动备份任务](#重新启动备份任务)来完成恢复。 +如果不满足上述条件或者要恢复到时间点，当存在日志备份任务时，BR 会拒绝恢复数据。此时可以通过以下方式完成恢复：先[停止备份任务](#停止日志备份任务)然后进行数据恢复，在恢复完成后重新进行快照备份并[重新启动备份任务](#重新启动备份任务)。 > **注意：** > -> 恢复记录了全量恢复的日志备份的时候，也需要使用大于 `v9.0.0` 版本的 BR。 否则可能导致记录下来的全量恢复无法被恢复。 \ No newline at end of file +> 当恢复记录了全量恢复数据的日志备份时，需要使用 v9.0.0 及之后版本的 BR，否则可能导致记录下来的全量恢复数据无法被恢复。 \ No newline at end of file From d5a5650af6673e4429cfab495f77e8b786af9166 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Tue, 8 Apr 2025 17:23:17 +0800 Subject: [PATCH 4/8] Update format --- br/br-pitr-manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index ba339765f9bb..d2cd89538298 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -496,7 +496,7 @@ tiup br restore point --pd="${PD_IP}:2379" --master-key "local:///path/to/master.key" ``` -### 进行中日志备份与恢复的兼容性 从 v9.0.0 版本开始引入 +### 进行中日志备份与恢复的兼容性 从 v9.0.0 开始，当存在日志备份任务时，如果**同时满足**以下条件，则可以正常进行快照恢复 (`br restore [full|database|table]`) 并且恢复的数据可以被进行中的日志备份（下称“日志备份”）正常记录： From eba143ea105f5761046f0d67b3e3e02c026259ba Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Wed, 9 Apr 2025 15:06:46 +0800 Subject: [PATCH 5/8] Apply suggestions from code review Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- br/br-pitr-manual.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index d2cd89538298..80c451a2f247 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -496,16 +496,21 @@ tiup br restore point --pd="${PD_IP}:2379" --master-key "local:///path/to/master.key" ``` -### 进行中日志备份与恢复的兼容性 +### 进行中的日志备份与恢复的兼容性 -从 v9.0.0 开始，当存在日志备份任务时，如果**同时满足**以下条件，则可以正常进行快照恢复 (`br restore [full|database|table]`) 并且恢复的数据可以被进行中的日志备份（下称“日志备份”）正常记录： +从 v9.0.0 开始，当存在日志备份任务时，如果**同时满足**以下条件，则可以正常进行快照恢复 (`br restore [full|database|table]`)，并且恢复的数据可以被进行中的日志备份（下称“日志备份”）正常记录： -- 对于执行备份恢复操作的节点，除了有执行快照恢复需要的对备份来源外部存储的权限之外，还需要具有写入日志备份目标外部存储的权限。 -- 日志备份的目标外部存储类型是 S3 (`s3://`)、GCS (`gcs://`) 或 Azure Blob Storage (`azblob://`)。 +- 执行备份恢复操作的节点需要具备：对备份来源外部存储的读取权限以执行快照恢复，以及对日志备份目标外部存储的写入权限。 +- 日志备份的目标外部存储类型是 Amazon S3 (`s3://`)、Google Cloud Storage (`gcs://`) 或 Azure Blob Storage (`azblob://`)。 - 待恢复的数据与日志备份的目标存储拥有相同的外部存储类型。 - 待恢复的数据和日志备份均未开启本地加密，参考[日志备份加密](#加密日志备份数据)和[快照备份加密](/br/br-snapshot-manual.md#备份数据加密)。 -如果不满足上述条件或者要恢复到时间点，当存在日志备份任务时，BR 会拒绝恢复数据。此时可以通过以下方式完成恢复：先[停止备份任务](#停止日志备份任务)然后进行数据恢复，在恢复完成后重新进行快照备份并[重新启动备份任务](#重新启动备份任务)。 +如果不能同时满足上述条件或者要恢复到时间点，当存在日志备份任务时，BR 会拒绝恢复数据。此时，可以通过以下步骤完成数据恢复： + +1. [停止备份任务](#停止日志备份任务)。 +2. 进行数据恢复。 +3. 恢复完成后，重新进行快照备份。 +4. [重新启动备份任务](#重新启动备份任务)。 > **注意：** > From 7a925f8e6252b6969819fe35dff4a15f05a25bd0 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Wed, 9 Apr 2025 15:10:36 +0800 Subject: [PATCH 6/8] Update wording --- br/br-pitr-manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index 80c451a2f247..28e87f43c64c 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -514,4 +514,4 @@ tiup br restore point --pd="${PD_IP}:2379" > **注意：** > -> 当恢复记录了全量恢复数据的日志备份时，需要使用 v9.0.0 及之后版本的 BR，否则可能导致记录下来的全量恢复数据无法被恢复。 \ No newline at end of file +> 当恢复记录了快照（全量）恢复数据的日志备份时，需要使用 v9.0.0 及之后版本的 BR，否则可能导致记录下来的全量恢复数据无法被恢复。 \ No newline at end of file From c789fb24edb7357630d5cbcb5d5bdc0708778ab0 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Wed, 9 Apr 2025 15:14:37 +0800 Subject: [PATCH 7/8] Improve wording consistency --- br/br-pitr-manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index 28e87f43c64c..aa4a720d669c 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -496,7 +496,7 @@ tiup br restore point --pd="${PD_IP}:2379" --master-key "local:///path/to/master.key" ``` -### 进行中的日志备份与恢复的兼容性 +### 进行中的日志备份与快照恢复的兼容性 从 v9.0.0 开始，当存在日志备份任务时，如果**同时满足**以下条件，则可以正常进行快照恢复 (`br restore [full|database|table]`)，并且恢复的数据可以被进行中的日志备份（下称“日志备份”）正常记录： From 0cdfeae1efd0217382278100adc66e2de6dffcf0 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Thu, 10 Apr 2025 10:21:45 +0800 Subject: [PATCH 8/8] Apply suggestions from code review Co-authored-by: xixirangrang --- br/br-pitr-manual.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index aa4a720d669c..8932bef2b14c 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -500,7 +500,9 @@ tiup br restore point --pd="${PD_IP}:2379" 从 v9.0.0 开始，当存在日志备份任务时，如果**同时满足**以下条件，则可以正常进行快照恢复 (`br restore [full|database|table]`)，并且恢复的数据可以被进行中的日志备份（下称“日志备份”）正常记录： -- 执行备份恢复操作的节点需要具备：对备份来源外部存储的读取权限以执行快照恢复，以及对日志备份目标外部存储的写入权限。 +- 执行备份恢复操作的节点需要同时具备以下权限： + - 对备份来源外部存储的读取权限，用于执行快照恢复 + - 对日志备份目标外部存储的写入权限 - 日志备份的目标外部存储类型是 Amazon S3 (`s3://`)、Google Cloud Storage (`gcs://`) 或 Azure Blob Storage (`azblob://`)。 - 待恢复的数据与日志备份的目标存储拥有相同的外部存储类型。 - 待恢复的数据和日志备份均未开启本地加密，参考[日志备份加密](#加密日志备份数据)和[快照备份加密](/br/br-snapshot-manual.md#备份数据加密)。