pingcap · toutdesuite · Mar 17, 2020 · Mar 11, 2020 · Mar 11, 2020 · Mar 11, 2020
diff --git a/TOC.md b/TOC.md
@@ -82,7 +82,7 @@
   + Maintain
     - [Common Ansible Operations](/how-to/deploy/orchestrated/ansible-operations.md)
     + Backup and Restore
-      - [Use `mydumper` and `loader`](/how-to/maintain/backup-and-restore/mydumper-loader.md)
+      - [Use Mydumper and TiDB Lightning](/how-to/maintain/backup-and-restore/mydumper-lightning.md)
       - [Use BR](/reference/tools/br/br.md)
       - [BR Usage Scenarios](/reference/tools/br/use-cases.md)
     + Identify Abnormal Queries

diff --git a/how-to/maintain/backup-and-restore/mydumper-lightning.md b/how-to/maintain/backup-and-restore/mydumper-lightning.md
@@ -0,0 +1,97 @@
+---
+title: Use Mydumper and TiDB Lightning for Backup and Restoration
+category: how-to
+aliases: ['/docs/dev/how-to/maintain/backup-and-restore/']
+---
+
+# Use Mydumper and TiDB Lightning for Data Backup and Restoration
+
+This document describes how to perform full backup and restoration of the TiDB data using Mydumper and TiDB Lightning. For incremental backup and restoration, refer to [TiDB Binlog](/reference/tidb-binlog/overview.md).
+
+Suppose that the TiDB service information is as follows:
+
+|Name|Address|Port|User|Password|
+|:----|:-------|:----|:----|:--------|
+|TiDB|127.0.0.1|4000|root|*|
+
+Use the following tools for data backup and restoration:
+
+- [Mydumper](/reference/tools/mydumper.md): to export data from TiDB
+- [TiDB Lightning](/reference/tools/tidb-lightning/overview.md): to import data into TiDB
+
+## Full backup and restoration using Mydumper/TiDB Lightning
+
+`mydumper` is a powerful data backup tool. For more information, refer to [`maxbube/mydumper`](https://github.com/maxbube/mydumper).
+
+Use [Mydumper](/reference/tools/mydumper.md) to export data from TiDB and use [TiDB Lightning](/reference/tools/tidb-lightning/overview.md) to import data into TiDB.
+
+> **Note:**
+>
+> It is recommended to download [Mydumper](/reference/tools/mydumper.md) from the PingCAP website, because the R&D team has adapted `mydumper` for TiDB. It is not recommended to use `mysqldump` which is much slower for both backup and restoration.
+
+### Best practices for full backup and restoration using Mydumper/TiDB Lightning
+
+To quickly backup and restore data (especially large amounts of data), refer to the following recommendations:
+
+* Keep the exported data file as small as possible. It is recommended to use the `-F` parameter to set the file size. If you use TiDB Lightning to restore data, it is recommended that you set the value of `-F` to `256` (MB). If you use `loader` for restoration, it is recommended to set the value to `64` (MB).
+
+## Backup data from TiDB
+
+Use `mydumper` to backup data from 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
+```
+
+In this command,
+
+`-B test` means that the data is exported from the `test` database.
+`-T t1,t2` means that only the `t1` and `t2` tables are exported.
+`-t 32` means that 32 threads are used to export the data.
+`-F 256` means that a table is partitioned into chunks, and one chunk is 256MB.
+`--skip-tz-utc` means to ignore the inconsistency of time zone setting between MySQL and the data exporting machine and to disable automatic conversion.
+
+If `mydumper` returns the following error:
+
+```
+** (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
+```
+
+Then execute two more commands:
+
+1. Before executing the `mydumper` command, query the [GC](/reference/garbage-collection/overview.md) values of the TiDB cluster and adjust it to a suitable value using the MySQL client:
+
+    {{< 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. After running the `mydumper` command, adjust GC value of the TiDB cluster to its original value in step 1.
+
+    {{< copyable "sql" >}}
+
+    ```sql
+    update mysql.tidb set VARIABLE_VALUE = '10m' where VARIABLE_NAME = 'tikv_gc_life_time';
+    ```
+
+## Restore data into TiDB
+
+To restore data into TiDB, use TiDB Lightning to import the exported data. See [TiDB Lightning Tutorial](/reference/tools/tidb-lightning/tidb-backend.md).
diff --git a/how-to/maintain/backup-and-restore/mydumper-loader.md b/how-to/maintain/backup-and-restore/mydumper-loader.md
diff --git a/reference/tools/br/br.md b/reference/tools/br/br.md
@@ -7,7 +7,7 @@ aliases: ['/docs/dev/how-to/maintain/backup-and-restore/br/']
 
 # Use BR to Back up and Restore Data
 
-Backup & Restore (BR) is a command-line tool for distributed backup and restoration of the TiDB cluster data. Compared with [`mydumper`/`loader`](/how-to/maintain/backup-and-restore/mydumper-loader.md), BR is more suitable for scenarios of huge data volume. This document describes the BR command line, detailed use examples, best practices, restrictions, and introduces the implementation principles of BR.
+Backup & Restore (BR) is a command-line tool for distributed backup and restoration of the TiDB cluster data. Compared with [`mydumper`/`loader`](/how-to/maintain/backup-and-restore/mydumper-lightning.md), BR is more suitable for scenarios of huge data volume. This document describes the BR command line, detailed use examples, best practices, restrictions, and introduces the implementation principles of BR.
 
 ## Usage restrictions