Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

br: fix typos and add correct aliases #12044

Merged
merged 9 commits into from
Nov 21, 2022
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
fix typo
  • Loading branch information
Oreoxmt committed Nov 21, 2022
commit a33028de6603e16cd7eb3ad7b5bacd1109cb3401
6 changes: 3 additions & 3 deletions br/br-log-architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ summary: 了解 TiDB 的日志备份与 PITR 的架构设计。

系统组件和关键概念:

* **local meta**:表示单 TiKV 节点备份下来的数据元信息,主要包括:local checkpoint ts、global checkpoint ts、备份文件信息。
* **local metadata**:表示单 TiKV 节点备份下来的数据元信息,主要包括:local checkpoint ts、global checkpoint ts、备份文件信息。
* **local checkpoint ts** (in local metadata):表示这个 TiKV 中所有小于 local checkpoint ts 的日志数据已经备份到目标存储。
* **global checkpoint ts**:表示所有 TiKV 中小于 global checkpoint ts 的日志数据已经备份到目标存储。它由运行在 TiDB 中的 Coordinator 模块收集所有 TiKV 的 local checkpoint ts 计算所得,然后上报给 PD。
* **TiDB Coordinator 组件**:TiDB 集群的某个节点会被选举为 Coordinator,负责收集和计算整个日志备份任务的进度 (global checkpoint ts)。该组件设计上无状态,在其故障后可以从存活的 TiDB 节点中重新选出一个节点作为 Coordinator。
Expand Down Expand Up @@ -59,7 +59,7 @@ PITR 的流程如下:

1. BR 接收恢复命令 `br restore point`。
* 解析获取全量备份数据地址、日志备份数据地址、恢复到的时间点。
* 查询备份数据中恢复数据对象(database 或 table),并检查要恢复的表是否符合要求不存在
* 查询备份数据中恢复数据对象(database 或 table),并检查要恢复的表是否存在并符合要求

2. BR 恢复全量备份。
* 进行快照备份数据恢复,恢复流程参考[恢复快照备份数据](/br/br-snapshot-architecture.md#恢复流程)。
Expand Down Expand Up @@ -88,7 +88,7 @@ PITR 的流程如下:
日志备份会产生如下类型文件:

- `{min_ts}-{uuid}.log` 文件:存储备份下来的 kv 数据变更记录。其中 `{min_ts}` 是该文件中所有 kv 数据变更记录数对应的最小 ts;`{uuid}` 是生成该文件的时候随机生成的。
- `{checkpoint_ts}-{uuid}.meta` 文件:每个 TiKV 节点每次上传日志备份数据时会生成一个该文件,保存本次上传的所有日志备份数据文件其中 `{checkpoint_ts}` 是本节点的日志备份的 checkpoint,所有 TiKV 节点的最小的 checkpoint 就是日志备份任务最新的 checkpoint;`{uuid}` 是生成该文件的时候随机生成的。
- `{checkpoint_ts}-{uuid}.meta` 文件:每个 TiKV 节点每次上传日志备份数据时会生成一个该文件,保存本次上传的所有日志备份数据文件。其中 `{checkpoint_ts}` 是本节点的日志备份的 checkpoint,所有 TiKV 节点的最小的 checkpoint 就是日志备份任务最新的 checkpoint;`{uuid}` 是生成该文件的时候随机生成的。
- `{store_id}.ts` 文件:每个 TiKV 节点每次上传日志备份数据时会使用 global checkpoint ts 更新该文件。其中 `{store_id}` 是 TiKV 的 store ID。
- `v1_stream_truncate_safepoint.txt` 文件:保存最近一次通过 `br log truncate` 删除日志备份数据后,存储中最早的日志备份数据对应的 ts。

Expand Down
8 changes: 3 additions & 5 deletions br/br-pitr-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ aliases: ['/zh/tidb/dev/pitr-usage/']

### 开启日志备份

执行 `br log start` 命令启动日志备份任务,一个集群只能启动一个日志备份任务。该命令输出结果如下:
执行 `br log start` 命令启动日志备份任务,一个集群只能启动一个日志备份任务。

```shell
tiup br log start --task-name=pitr --pd "${PD_IP}:2379" \
Expand Down Expand Up @@ -98,9 +98,7 @@ Restore KV Files <--------------------------------------------------------------
rm -rf s3://backup-101/snapshot-${date}
```

## 性能与影响

### PITR 的性能与影响
## PITR 的性能与影响

### 能力指标

Expand Down Expand Up @@ -131,5 +129,5 @@ Restore KV Files <--------------------------------------------------------------
## 探索更多

* [TiDB 集群备份与恢复实践示例](/br/backup-and-restore-use-cases.md)
* [br 命令行手册](/br/use-br-command-line-tool.md)
* [`br` 命令行手册](/br/use-br-command-line-tool.md)
* [日志备份与 PITR 架构设计](/br/br-log-architecture.md)
2 changes: 1 addition & 1 deletion br/br-snapshot-architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ summary: 了解 TiDB 快照备份与恢复功能的架构设计。

2. BR 调度恢复数据。
* **Pause Region schedule**:请求 PD 在恢复期间关闭自动 Region schedule。
* **Restore schema**:读取备份数据的 schema、恢复的 database 和 table(注意新建表的 table id 与备份数据可能不一样)。
* **Restore schema**:读取备份数据的 schema、恢复的 database 和 table(注意新建表的 table ID 与备份数据可能不一样)。
* **Split & scatter Region**:BR 基于备份数据信息,请求 PD 分配 Region (split Region),并调度 Region 均匀分布到存储节点上 (scatter Region)。每个 Region 都有明确的数据范围 [start key, end key)。
* **Request TiKV to restore data**:根据 PD 分配的 Region 结果,发送恢复请求到对应的 TiKV 节点,恢复请求包含要恢复的备份数据及 rewrite 规则。

Expand Down
2 changes: 1 addition & 1 deletion br/br-snapshot-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -174,4 +174,4 @@ TiDB 备份功能对集群性能(事务延迟和 QPS)有一定的影响,

* [TiDB 集群备份与恢复实践示例](/br/backup-and-restore-use-cases.md)
* [`br` 命令行手册](/br/use-br-command-line-tool.md)
* [快照备份与恢复架构设计](/br/br-snapshot-architecture.md)
* [快照备份与恢复架构设计](/br/br-snapshot-architecture.md)