Skip to content

Commit

Permalink
br: update PITR FAQ for v7.1 branch (#15756)
Browse files Browse the repository at this point in the history
  • Loading branch information
Oreoxmt authored Dec 15, 2023
1 parent beb0528 commit 1226dd1
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 9 deletions.
10 changes: 5 additions & 5 deletions faq/backup-and-restore-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,9 +44,9 @@ TiKV 支持[动态配置](/tikv-control.md#动态修改-tikv-的配置)自动调

### 索引加速功能为什么与 PITR 功能不兼容?

Issue 链接:[#38045](https://github.com/pingcap/tidb/issues/38045)
Issue 链接:[#38045](https://github.com/pingcap/tidb/issues/38045)(v7.0.0 已修复)

当前通过[索引加速功能](/system-variables.md#tidb_ddl_enable_fast_reorg-从-v630-版本开始引入)创建的索引数据无法被 PITR 备份。
在 v7.0.0 之前版本中,通过[索引加速功能](/system-variables.md#tidb_ddl_enable_fast_reorg-从-v630-版本开始引入)创建的索引数据无法被 PITR 备份。

因此,在 PITR 恢复完成后,BR 会将通过索引加速功能创建的索引数据删除,再重新创建。如果在日志备份期间通过索引加速功能创建的索引很多或索引数据很大,建议在创建索引后进行一次全量备份。

Expand All @@ -58,11 +58,11 @@ Issue 链接:[#13126](https://github.com/tikv/tikv/issues/13126)

### 执行 PITR 恢复时遇到 `execute over region id` 报错,该如何处理?

Issue 链接:[#37207](https://github.com/pingcap/tidb/issues/37207)
Issue 链接:[#37207](https://github.com/pingcap/tidb/issues/37207)(v6.6.0 已修复)

该场景发生在全量数据导入时开启了日志备份,并使用 PITR 恢复全量导入时间段的日志。经过测试发现,当存在长时间(24 小时)大量热点写入,且平均单台 TiKV 节点写入 OPS > 50k/s(可以通过 Grafana 中 **TiKV-Details** -> **Backup Log** -> **Handle Event Rate** 确认该数值),那么有几率会遇到这个情况。
在 v6.6.0 之前版本中,执行 PITR 恢复时可能会遇到 `execute over region id` 报错。该场景发生在全量数据导入时开启了日志备份,并使用 PITR 恢复全量导入时间段的日志。经过测试发现,当存在长时间(24 小时)大量热点写入,且平均单台 TiKV 节点写入 OPS > 50k/s(可以通过 Grafana 中 **TiKV-Details** -> **Backup Log** -> **Handle Event Rate** 确认该数值),那么有几率会遇到这个情况。

当前版本中建议在集群初始化后,进行一次有效快照备份,并且以此作为基础进行 PITR 恢复。
对于 v6.6.0 之前版本,建议在集群初始化后,进行一次有效快照备份,并且以此作为基础进行 PITR 恢复。

### 在使用 `br restore point` 命令恢复下游集群后,TiFlash 引擎数据没有恢复?

Expand Down
6 changes: 2 additions & 4 deletions system-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -1182,15 +1182,13 @@ MPP 是 TiFlash 引擎提供的分布式计算框架,允许节点之间的数
- TiDB v7.1.0 引入了快速加索引功能的检查点机制,即使 TiDB owner 因故障重启或者切换,也能够通过自动定期保存的检查点恢复部分进度。
- 要验证已经完成的 `ADD INDEX` 操作是否使用了添加索引加速功能,可以执行 [`ADMIN SHOW DDL JOBS`](/sql-statements/sql-statement-admin-show-ddl.md#admin-show-ddl-jobs) 语句查看 `JOB_TYPE` 一列中是否含有 `ingest` 字样。
> **警告:**
>
> 目前,PITR 恢复会额外处理日志备份时间段内通过索引加速功能创建的索引,以达到兼容效果。详细内容请参考[索引加速功能为什么与 PITR 功能不兼容](/faq/backup-and-restore-faq.md#索引加速功能为什么与-pitr-功能不兼容)。
> **注意:**
>
> * 要使用索引加速功能,你需要提供一个可写且具有足够空余空间的临时路径 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入)。如果 `temp-dir` 无法使用,TiDB 会退回到非加速的索引创建方式。建议将 `temp-dir` 挂载在 SSD 磁盘上。
>
> * 在升级到 v6.5.0 及以上版本时,请确保 TiDB 的 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入) 路径已正确挂载了 SSD 磁盘,并确保运行 TiDB 的操作系统用户对该目录有读写权限,否则在运行时可能产生不可预知的问题。该参数是 TiDB 的配置参数,设置后需要重启 TiDB 才能生效。因此,在升级前提前进行设置,可以避免再次重启。
>
> *v7.0.0 之前版本中,PITR 恢复会额外处理日志备份时间段内通过索引加速功能创建的索引,以达到兼容效果。详细内容请参考[索引加速功能为什么与 PITR 功能不兼容](/faq/backup-and-restore-faq.md#索引加速功能为什么与-pitr-功能不兼容)。
### `tidb_enable_dist_task` <span class="version-mark">从 v7.1.0 版本开始引入</span>
Expand Down

0 comments on commit 1226dd1

Please sign in to comment.