From 2214e513af6f8e4840299458ffa745234f798a68 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, 8 Jul 2021 14:33:29 +0800
Subject: [PATCH] br: add restore to systables (#6194)

---
 br/use-br-command-line-tool.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/br/use-br-command-line-tool.md b/br/use-br-command-line-tool.md
index e90c5d1ccd29..4c340825e951 100644
--- a/br/use-br-command-line-tool.md
+++ b/br/use-br-command-line-tool.md
@@ -381,6 +381,39 @@ br restore full \
 
 增量恢复的方法和使用 BR 进行全量恢复的方法并无差别。需要注意，恢复增量数据的时候，需要保证备份时指定的 `last backup ts` 之前备份的数据已经全部恢复到目标集群。
 
+### 恢复创建在 `mysql` 数据库下的表（实验性功能）
+
+BR 可以并且会默认备份 `mysql` 数据库下的表。
+
+在执行恢复时，`mysql` 下的表默认不会被恢复。如果需要恢复 `mysql` 下的用户创建的表，可以通过 [table filter](/table-filter.md#表库过滤语法) 来显式地包含目标表。以下示例中要恢复目标用户表为 `mysql.usertable`；该命令会在执行正常的恢复的同时恢复 `mysql.usertable`。
+
+{{< copyable "shell-regular" >}}
+
+```shell
+br restore full -f '*.*' -f '!mysql.*' -f 'mysql.usertable' -s $external_storage_url
+```
+
+在如上的命令中，`-f '*.*'` 用于覆盖掉默认的规则，`-f '!mysql.*'` 指示 BR 不要恢复 `mysql` 中的表，除非另有指定。`-f 'mysql.usertable'` 则指定需要恢复 `mysql.usertable`。具体原理请参考 [table filter 的文档](/table-filter.md#表库过滤语法)。
+
+如果只需要恢复 `mysql.usertable`，而无需恢复其他表，可以使用以下命令：
+
+{{< copyable "shell-regular" >}}
+
+```shell
+br restore full -f 'mysql.usertable' -s $external_storage_url
+```
+
+> **警告：**
+>
+> 虽然系统表（例如 `mysql.tidb` 等）可以通过 BR 进行备份和恢复，但是部分系统表在恢复之后可能会出现非预期的状况，已知的异常如下：
+>
+> - 统计信息表（`mysql.stat_*`）无法被恢复。
+> - 系统变量表（`mysql.tidb`，`mysql.global_variables`）无法被恢复。
+> - 用户信息表（`mysql.user`，`mysql.columns_priv`，等等）无法被恢复。
+> - GC 数据无法被恢复。
+> 
+> 恢复系统表可能还存在更多兼容性问题。为了防止意外发生，请避免在生产环境中恢复系统表。
+
 ### Raw KV 恢复（实验性功能）
 
 > **警告：**