From 5d8a2140e73043bb47a76f4c347e10b03734eca5 Mon Sep 17 00:00:00 2001 From: Yu Juncen Date: Thu, 6 Mar 2025 16:20:34 +0800 Subject: [PATCH 1/9] =?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 a03f2e85b248..aae9cfe10a12 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -497,4 +497,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 1ed5d54d7da2933e97da544c040911f180b660df 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/9] 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 aae9cfe10a12..119e8fd215a6 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -503,7 +503,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 8dd0ed25908a8a5835bb4ec3ab24492af6a1ea84 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/9] 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 119e8fd215a6..e5577215a70c 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -501,15 +501,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 a879f6a55deb8f991c9540296c01f134bd617d1f Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Tue, 8 Apr 2025 17:23:17 +0800 Subject: [PATCH 4/9] 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 e5577215a70c..8e55495efaf5 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -499,7 +499,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 76b9f95eaf5f54cda887bfc7695eee588a97114a Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Wed, 9 Apr 2025 15:06:46 +0800 Subject: [PATCH 5/9] 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 8e55495efaf5..93337f87fdf8 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -499,16 +499,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 289f19c465cdb98598f70dde058bc5dd08910edf Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Wed, 9 Apr 2025 15:10:36 +0800 Subject: [PATCH 6/9] 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 93337f87fdf8..3efd19748751 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -517,4 +517,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 d71d49a1c4157de2800c8aca653900adae4d2903 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Wed, 9 Apr 2025 15:14:37 +0800 Subject: [PATCH 7/9] 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 3efd19748751..307c15812a0c 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -499,7 +499,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 4591436305759059784773e2a56fb7969810f581 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Thu, 10 Apr 2025 10:21:45 +0800 Subject: [PATCH 8/9] 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 307c15812a0c..4d5a1ad4124a 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -503,7 +503,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#备份数据加密)。 From 21fa0be6a89710fe995be46fdde1fccea0c0de2d Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 16 Dec 2025 10:15:34 +0800 Subject: [PATCH 9/9] v9.0.0 -> v8.5.5 --- br/br-pitr-manual.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/br/br-pitr-manual.md b/br/br-pitr-manual.md index 4d5a1ad4124a..0af74890467c 100644 --- a/br/br-pitr-manual.md +++ b/br/br-pitr-manual.md @@ -501,7 +501,7 @@ tiup br restore point --pd="${PD_IP}:2379" ### 进行中的日志备份与快照恢复的兼容性 -从 v9.0.0 开始，当存在日志备份任务时，如果**同时满足**以下条件，则可以正常进行快照恢复 (`br restore [full|database|table]`)，并且恢复的数据可以被进行中的日志备份（下称“日志备份”）正常记录： +从 v8.5.5 开始，当存在日志备份任务时，如果**同时满足**以下条件，则可以正常进行快照恢复 (`br restore [full|database|table]`)，并且恢复的数据可以被进行中的日志备份（下称“日志备份”）正常记录： - 执行备份恢复操作的节点需要同时具备以下权限： - 对备份来源外部存储的读取权限，用于执行快照恢复 @@ -519,4 +519,4 @@ tiup br restore point --pd="${PD_IP}:2379" > **注意：** > -> 当恢复记录了快照（全量）恢复数据的日志备份时，需要使用 v9.0.0 及之后版本的 BR，否则可能导致记录下来的全量恢复数据无法被恢复。 \ No newline at end of file +> 当恢复记录了快照（全量）恢复数据的日志备份时，需要使用 v8.5.5 及之后版本的 BR，否则可能导致记录下来的全量恢复数据无法被恢复。 \ No newline at end of file