Add document of dumpling, the new export tool

TOC.md

@@ -190,6 +190,7 @@
     - [Ansible 常见运维操作](/maintain-tidb-using-ansible.md)
     + 备份与恢复
       - [使用 Mydumper/TiDB Lightning 进行备份与恢复](/backup-and-restore-using-mydumper-lightning.md)
+      - [使用 Dumpling 进行数据导出](/export-using-dumpling.md)
       - [使用 BR 进行备份与恢复](/br/backup-and-restore-tool.md)
       - [BR 备份与恢复场景示例](/br/backup-and-restore-use-cases.md)
     + 定位异常查询

backup-and-restore-using-mydumper-lightning.md

@@ -6,6 +6,12 @@ aliases: ['/docs-cn/dev/how-to/maintain/backup-and-restore/mydumper-lightning/',
 
 # 使用 Mydumper/TiDB Lightning 进行备份与恢复
 
+> **警告：**
+> 
+> 本文中提到的 `MyDumper` 已经不再由我们维护。
+> 
+> 建议尽可能转移到新的数据导出工具 [Dumpling](/export-using-dumpling.md) 加上现有的 [TiDB Lightning](/tidb-lightning/tidb-lightning-overview.md) 完成全量数据的备份与恢复。
+
 本文档将详细介绍如何使用 Mydumper/TiDB Lightning 对 TiDB 进行全量备份与恢复。增量备份与恢复可使用 [TiDB Binlog](/tidb-binlog/tidb-binlog-overview.md)。
 
 这里假定 TiDB 服务信息如下：

export-using-dumpling.md

@@ -0,0 +1,96 @@
+---
+title: 使用 Dumpling 进行数据导出
+summary: 使用新的导出工具 Dumpling 导出或者备份数据。
+category: how-to
+---
+
+# 使用 Dumpling 进行数据导出
+
+本文档将会介绍如何使用新的导出工具 Dumpling。
+它可以把 TiDB 中存储的数据导出为 SQL 或者 CSV 格式，可以用它完成逻辑上的全量备份或者导出。
+如果需要直接备份 SST 文件（KV 对）或者对延迟不敏感的增量备份，请参阅 [BR](/br/backup-and-restore-tool.md)。
+如果需要实时的增量备份，请参阅 [TiCDC](/ticdc/ticdc-overview.md)。
+
+接下来，我们会假设你已经启动了待导出的集群。当然，如果你只是想玩一下这个工具，也可以用 [TiUP](/tiup/tiup-overview.md) 现场搭建一个：
+
+{{< copyable "shell-regular" >}}
+
+```shell
+tiup playground
+```
+
+然后用 `sysbench` 灌入测试用的数据：
+
+{{< copyable "shell-regular" >}}
+
+```shell
+sysbench --mysql-host=127.0.0.1 \
+    --mysql-user=root \
+    --mysql-port=4000 \
+    --mysql-db=test \
+    oltp_insert \
+    --tables=3 --table-size=1000 prepare
+```
+
+## 从 TiDB 导出数据
+
+使用如下命令导出数据：
+
+{{< copyable "shell-regular" >}}
+
+```shell
+dumpling \
+  -u root \
+  -P 4000 \
+  -H 127.0.0.1 \
+  --filetype sql \
+  --threads 32 \
+  -o /tmp/test \
+  -F $(( 1024 * 1024 * 256 ))
+```
+
+这个命令中，`-H`，`-P`，`-u` 是经典的“地址，端口，用户”三元组。如果需要密码验证，可以用 `-p $YOUR_SECRET_PASSWORD` 传给 Dumpling。
+
+默认情况下，除了系统数据库中的表之外，Dumpling 会导出整个数据库的表。你可以使用 `--where` 来选定要导出的记录。假如导出数据的格式是 CSV（使用 `--filetype csv` 即可导出 CSV 文件），还可以使用 `--sql` 导出指定 SQL 选择出来的记录。
+
+> **注意：**
+> 
+> 截止到这篇文章写作时候，Dumpling 暂时还不支持仅导出用户指定的某几张表（见[这个 issue](https://github.com/pingcap/dumpling/issues/76)）。
+> 如果你确实需要这些功能，可以先使用 [MyDumper](/backup-and-restore-using-mydumper-lightning.md)。
+
+默认情况下，导出的文件会存储到 `./export-<current local time>` 目录下。你可以使用 `-o` 来选择存储导出文件的目录。`-F` 选项能够指定单个文件的最大大小（和 MyDumper 不同，这里的单位是字节），与之相似的是 `-r` 选项，它指定单个文件的最大记录数（或者说，数据库中的行数）。利用这些参数可以让 Dumpling 的并行度更高。
+
+除此之外，你可以使用 `--snapshot` 标志来指定欲导出快照的时间戳。与之相关的是 `--consistency`，这个标志控制导出数据“一致性保证”的方式。对于 TiDB 来说，默认情况下我们会通过获取某个时间戳的快照来保证一致性，因此我们才可以使用 `--snapshot` 参数指定要备份的时间戳。
+
+一切完成之后，你应该可以在 `/tmp/test` 看到导出的文件了：
+
+``` shell
+$ ls -lh /tmp/test | awk '{print $5 "\t" $9}'
+
+140B  metadata
+66B   test-schema-create.sql
+300B  test.sbtest1-schema.sql
+190K  test.sbtest1.0.sql
+300B  test.sbtest2-schema.sql
+190K  test.sbtest2.0.sql
+300B  test.sbtest3-schema.sql
+190K  test.sbtest3.0.sql
+```
+
+另外，假如数据量非常大，可以提前调长 GC 时间避免因为导出中 GC 导致导出失败：
+
+{{< copyable "sql" >}}
+
+```sql
+update mysql.tidb set VARIABLE_VALUE = '720h' where VARIABLE_NAME = 'tikv_gc_life_time';
+```
+
+在操作结束之后，再将 GC 时间调回原样（默认是 `10m`）：
+
+{{< copyable "sql" >}}
+
+```sql
+update mysql.tidb set VARIABLE_VALUE = '10m' where VARIABLE_NAME = 'tikv_gc_life_time';
+```
+
+最后，所有的这些导出数据都可以用 [Lightning](/tidb-lightning/tidb-lightning-tidb-backend.md) 导入回 TiDB。

mydumper-overview.md

@@ -7,6 +7,12 @@ aliases: ['/docs-cn/dev/reference/tools/mydumper/']
 
 # Mydumper 使用文档
 
+> **警告：**
+> 
+> 本文中提到的 `MyDumper` 已经不再由我们维护。
+> 
+> 建议尽可能转移到新的数据导出工具 [Dumpling](/export-using-dumpling.md)。
+
 ## Mydumper 简介
 
 [Mydumper](https://github.com/pingcap/mydumper) 是一个 fork 项目，针对 TiDB 的特性进行了优化，推荐使用此工具对 TiDB 进行逻辑备份。