Skip to content

Commit

Permalink
refine wording (pingcap#2)
Browse files Browse the repository at this point in the history
Signed-off-by: Aolin <aolin.zhang@pingcap.com>
  • Loading branch information
Oreoxmt authored and ti-chi-bot committed Dec 15, 2023
1 parent 81dcd96 commit 5f3c669
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 7 deletions.
14 changes: 11 additions & 3 deletions faq/backup-and-restore-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,11 +42,11 @@ TiKV 支持[动态配置](/tikv-control.md#动态修改-tikv-的配置)自动调

在创建日志备份任务的上游集群中,请尽量避免使用 TiDB Lightning 物理导入模式导入数据。可以选择使用 TiDB Lightning 逻辑导入模式导入数据。若确实需要使用物理导入模式,可在导入完成之后做一次快照备份操作,这样,PITR 就可以恢复到快照备份之后的时间点。

### 索引加速功能为什么与 PITR 功能不兼容?(已在 v7.1 修复)
### 索引加速功能为什么与 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 @@ -56,6 +56,14 @@ Issue 链接:[#13126](https://github.com/tikv/tikv/issues/13126)

在集群出现网络分区故障后,备份任务难以继续备份日志,并且在超过一定的重试时间后,任务会被置为 `ERROR` 状态。此时备份任务已经停止,需要手动执行 `br log resume` 命令来恢复日志备份任务。

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

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

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

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

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

PITR 目前不支持在恢复阶段直接将数据写入 TiFlash,在数据恢复完成后,br 会执行 `ALTER TABLE table_name SET TIFLASH REPLICA ***`,因此 TiFlash 副本在 PITR 完成恢复之后并不能马上可用,而是需要等待一段时间从 TiKV 节点同步数据。要查看同步进度,可以查询 `INFORMATION_SCHEMA.tiflash_replica` 表中的 `progress` 信息。
Expand Down
6 changes: 2 additions & 4 deletions system-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -1383,15 +1383,13 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
- 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 功能不兼容?(已在 v7.1 修复)](/faq/backup-and-restore-faq.md#索引加速功能为什么与-pitr-功能不兼容已在-v71-修复)。

> **注意:**
>
> * 要使用索引加速功能,你需要提供一个可写且具有足够空余空间的临时路径 [`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 5f3c669

Please sign in to comment.