Skip to content

Commit

Permalink
br: modify the faqs of pitr (#15366) (#15759)
Browse files Browse the repository at this point in the history
  • Loading branch information
ti-chi-bot authored Dec 15, 2023
1 parent 900e5ce commit c96e2f6
Show file tree
Hide file tree
Showing 2 changed files with 0 additions and 20 deletions.
16 changes: 0 additions & 16 deletions faq/backup-and-restore-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,28 +42,12 @@ TiKV 支持[动态配置](/tikv-control.md#动态修改-tikv-的配置)自动调

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

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

Issue 链接:[#38045](https://github.com/pingcap/tidb/issues/38045)

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

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

### 集群已经恢复了网络分区故障,为什么日志备份任务进度 checkpoint 仍然不推进?

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)

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

当前版本中建议在集群初始化后,进行一次有效快照备份,并且以此作为基础进行 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
4 changes: 0 additions & 4 deletions system-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -1383,10 +1383,6 @@ 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 功能不兼容](/faq/backup-and-restore-faq.md#索引加速功能为什么与-pitr-功能不兼容)。

> **注意:**
>
> * 要使用索引加速功能,你需要提供一个可写且具有足够空余空间的临时路径 [`temp-dir`](/tidb-configuration-file.md#temp-dir-从-v630-版本开始引入)。如果 `temp-dir` 无法使用,TiDB 会退回到非加速的索引创建方式。建议将 `temp-dir` 挂载在 SSD 磁盘上。
Expand Down

0 comments on commit c96e2f6

Please sign in to comment.