*: replace loader by lightning

dev/TOC.md

@@ -60,7 +60,7 @@
   + 运维
     - [Ansible 常见运维操作](/dev/how-to/maintain/ansible-operations.md)
     + 备份与恢复
-      - [使用 Mydumper/Loader 进行备份与恢复](/dev/how-to/maintain/backup-and-restore/mydumper-loader.md)
+      - [使用 Mydumper/Loader 进行备份与恢复](/dev/how-to/maintain/backup-and-restore/mydumper-lightning.md)
       - [使用 BR 进行备份与恢复](/dev/reference/tools/br/br.md)
       - [BR 备份与恢复最佳实践](/dev/reference/tools/br/br-best-practices.md)
     + 定位异常查询

dev/how-to/maintain/backup-and-restore/mydumper-lightning.md

@@ -0,0 +1,95 @@
+---
+title: 使用 mydumper/tidb lightning 进行备份与恢复
+category: how-to
+aliases: ['/docs-cn/dev/how-to/maintain/backup-and-restore/mydumper-lightning']
+---
+
+# 备份与恢复
+
+本文档将详细介绍如何使用 `mydumper`/`tidb lightning` 对 TiDB 进行全量备份与恢复。增量备份与恢复可使用 [TiDB Binlog](/dev/reference/tidb-binlog/overview.md)。
+
+这里我们假定 TiDB 服务信息如下：
+
+|Name|Address|Port|User|Password|
+|----|-------|----|----|--------|
+|TiDB|127.0.0.1|4000|root|*|
+
+在这个备份恢复过程中，我们会用到下面的工具：
+
+- [Mydumper](/dev/reference/tools/mydumper.md) 从 TiDB 导出数据
+- [TiDB Lightning](/dev/reference/tools/tidb-lightning/overview.md) 导入数据到 TiDB
+
+## 使用 `mydumper`/`tidb lightning` 全量备份恢复数据
+
+`mydumper` 是一个强大的数据备份工具，具体可以参考 [`maxbube/mydumper`](https://github.com/maxbube/mydumper)。
+
+可使用 [`mydumper`](/dev/reference/tools/mydumper.md) 从 TiDB 导出数据进行备份，然后用 [TiDB Lightning](/dev/reference/tools/tidb-lightning/overview.md) 将其导入到 TiDB 里面进行恢复。
+
+> **注意：**
+>
+> PingCAP 研发团队对 `mydumper` 进行了针对 TiDB 的适配性改造，建议使用 PingCAP 官方提供的 [`mydumper`](/dev/reference/tools/mydumper.md)。由于使用 `mysqldump` 进行数据备份和恢复都要耗费许多时间，这里也并不推荐。
+
+### `mydumper`/`tidb lightning` 全量备份恢复最佳实践
+
+为了快速地备份恢复数据 (特别是数据量巨大的库)，可以参考以下建议：
+
+* 使用 `mydumper` 导出来的数据文件尽可能的小, 可以通过设置参数 `-F` 来控制导出来的文件大小。如果后续使用  TiDB Lightning 对备份文件进行恢复，建议把 `mydumper` -F 参数的值设置为 `256`（单位 MB）；如果使用 `loader` 恢复，则建议设置为 `64`（单位 MB）。
+
+## 从 TiDB 备份数据
+
+我们使用 `mydumper` 从 TiDB 备份数据，如下:
+
+{{< copyable "shell-regular" >}}
+
+```bash
+./bin/mydumper -h 127.0.0.1 -P 4000 -u root -t 32 -F 256 -B test -T t1,t2 --skip-tz-utc -o ./var/test
+```
+
+上面，我们使用 `-B test` 表明是对 `test` 这个 database 操作，然后用 `-T t1,t2` 表明只导出 `t1`，`t2` 两张表。
+
+`-t 32` 表明使用 32 个线程去导出数据。`-F 256` 是将实际的 table 切分成多大的 chunk，这里就是 256MB 一个 chunk。
+
+`--skip-tz-utc` 添加这个参数忽略掉 TiDB 与导数据的机器之间时区设置不一致的情况，禁止自动转换。
+
+如果 `mydumper` 出现以下报错：
+
+```
+** (mydumper:27528): CRITICAL **: 13:25:09.081: Could not read data from testSchema.testTable: GC life time is shorter than transaction duration, transaction starts at 2019-08-05 21:10:01.451 +0800 CST, GC safe point is 2019-08-05 21:14:53.801 +0800 CST
+```
+
+就再执行两步命令：
+
+1. 执行 `mydumper` 命令前，查询 TiDB 集群的 GC 值并使用 MySQL 客户端将其调整为合适的值。
+
+    {{< copyable "sql" >}}
+
+    ```sql
+    SELECT * FROM mysql.tidb WHERE VARIABLE_NAME = 'tikv_gc_life_time';
+    ```
+
+    ```
+    +-----------------------+------------------------------------------------------------------------------------------------+
+    | VARIABLE_NAME         | VARIABLE_VALUE                                                                                 |
+    +-----------------------+------------------------------------------------------------------------------------------------+
+    | tikv_gc_life_time     | 10m0s                                                                                          |
+    +-----------------------+------------------------------------------------------------------------------------------------+
+    1 rows in set (0.02 sec)
+    ```
+
+    {{< copyable "sql" >}}
+
+    ```sql
+    update mysql.tidb set VARIABLE_VALUE = '720h' where VARIABLE_NAME = 'tikv_gc_life_time';
+    ```
+
+2. 执行 `mydumper` 命令后，将 TiDB 集群的 GC 值恢复到第 1 步中的初始值。
+
+    {{< copyable "sql" >}}
+
+    ```sql
+    update mysql.tidb set VARIABLE_VALUE = '10m' where VARIABLE_NAME = 'tikv_gc_life_time';
+    ```
+
+## 向 TiDB 恢复数据
+
+我们使用 `tidb lightning` 将之前导出的数据导入到 TiDB，完成恢复操作。具体的使用方法见 [tidb lightning 使用文档](/dev/reference/tools/tidb-lightning/tidb-backend.md)

dev/reference/tools/br/br.md

@@ -6,7 +6,7 @@ category: how-to
 
 # 使用 BR 进行备份与恢复
 
-Backup & Restore（以下简称 BR）是 TiDB 分布式备份恢复的命令行工具，用于对 TiDB 集群进行数据备份和恢复。相比 [`mydumper`/`loader`](/dev/how-to/maintain/backup-and-restore/mydumper-loader.md)，BR 更适合大数据量的场景。本文档介绍了 BR 的使用限制、工作原理、命令行描述、备份恢复用例以及最佳实践。
+Backup & Restore（以下简称 BR）是 TiDB 分布式备份恢复的命令行工具，用于对 TiDB 集群进行数据备份和恢复。相比 [`mydumper`/`loader`](/dev/how-to/maintain/backup-and-restore/mydumper-lightning.md)，BR 更适合大数据量的场景。本文档介绍了 BR 的使用限制、工作原理、命令行描述、备份恢复用例以及最佳实践。
 
 ## 使用限制
 

dev/reference/tools/use-guide.md

@@ -130,7 +130,7 @@ Loader 使用 SQL 的方式进行全量数据恢复，效率较低。TiDB Lightn
 
 针对 TiDB 的 2.1，3.0 以及 3.1 版本，下面给出典型业务场景下的数据迁移方案。
 
-### TiDB 2.1 和 3.0 全链路数据迁移方案
+### TiDB 3.0 全链路数据迁移方案
 
 #### MySQL 数据迁移到 TiDB
 

v2.1/TOC.md

@@ -260,7 +260,6 @@
       - [常见错误修复](/v2.1/reference/tidb-binlog/troubleshoot/error-handling.md)
     - [FAQ](/v2.1/reference/tidb-binlog/faq.md)
   + 周边工具
-    - [工具使用指南](/v2.1/reference/tools/use-guide.md)
     - [Mydumper](/v2.1/reference/tools/mydumper.md)
     - [Loader](/v2.1/reference/tools/loader.md)
     - [Syncer](/v2.1/reference/tools/syncer.md)