使用 Dumpling 导出或备份 TiDB 数据

    如果需要直接备份 SST 文件（KV 对）或者对延迟不敏感的增量备份，请参阅 。如果需要实时的增量备份，请参阅 TiCDC。

    使用 Dumpling 时，需要在已经启动的集群上执行导出命令。本文假设在 有一个 TiDB 实例，并且这个 TiDB 实例中有无密码的 root 用户。

    使用如下命令导出数据：

    上述命令中，-H、-P、-u 分别是地址，端口，用户。如果需要密码验证，可以用 -p $YOUR_SECRET_PASSWORD 传给 Dumpling。

    默认情况下，除了系统数据库中的表之外，Dumpling 会导出整个数据库的表。你可以使用 --where <SQL where expression> 来选定要导出的记录。假如导出数据的格式是 CSV（使用 --filetype csv 即可导出 CSV 文件），还可以使用 --sql <SQL> 导出指定 SQL 选择出来的记录，例如，导出 test.sbtest1 中所有 id < 100 的记录：

    1. ./dumpling \
    2.   -u root \
    3.   -P 4000 \
    4.   -H 127.0.0.1 \
    5.   -o /tmp/test \
    6.   --filetype csv \

    注意：

    目前 Dumpling 不支持仅导出用户指定的某几张表（即 -T 标志，见）。如果你确实需要这些功能，可以先使用 MyDumper。

    默认情况下，导出的文件会存储到 ./export-<current local time> 目录下。常用参数如下：

    • -F 选项用于指定单个文件的最大大小（和 MyDumper 不同，这里的单位是字节）。
    • -r 选项用于指定单个文件的最大记录数（或者说，数据库中的行数）。

    还有一个尚未在上面展示出来的标志是 --consistency <consistency level>，这个标志控制导出数据“一致性保证”的方式。对于 TiDB 来说，默认情况下，会通过获取某个时间戳的快照来保证一致性（即 --consistency snapshot）。在使用 snapshot 来保证一致性的时候，可以使用 --snapshot 参数指定要备份的时间戳。还可以使用以下的一致性级别：

    • flush：使用 来保证一致性。
    • snapshot：获取指定时间戳的一致性快照并导出。
    • ：为待导出的所有表上读锁。
    • none：不做任何一致性保证。
    • auto：对 MySQL 使用 flush，对 TiDB 使用 snapshot。

    一切完成之后，你应该可以在 /tmp/test 看到导出的文件了：

    1. $ ls -lh /tmp/test | awk '{print $5 "\t" $9}'
    2. 140B  metadata
    3. 66B   test-schema-create.sql
    4. 300B  test.sbtest1-schema.sql
    5. 190K  test.sbtest1.0.sql
    6. 300B  test.sbtest2-schema.sql
    7. 190K  test.sbtest2.0.sql
    8. 300B  test.sbtest3-schema.sql
    9. 190K  test.sbtest3.0.sql

    另外，假如数据量非常大，可以提前调长 GC 时间，以避免因为导出过程中发生 GC 导致导出失败：

    在操作结束之后，再将 GC 时间调回原样（默认是 ）：

      最后，所有的这些导出数据都可以用 Lightning 导入回 TiDB。