# Dumpling 导出 csv 文件

__*Dumpling 导出 CSV 文件*__

  + `./dumpling -u root -P 4000 -h 127.0.0.1 -o /tmp/test --filetype csv `


-------------------------------------------------------------
假如导出数据的格式是 CSV（使用 --filetype csv 即可导出 CSV 文件）,还可以使用 --sql <SQL> 导出指定 SQL 选择出来的记录,例如:

```
./dumpling -u root -P 4000 -h 127.0.0.1 -o /tmp/test --filetype csv 
```

--sql 选项仅仅可用于导出 CSV 文件的场景。上述命令将在要导出的所有表上执行 SELECT * FROM <table-name> WHERE id < 100 语句。如果部分表没有指定的字段,那么导出会失败。
使用 --sql 配置导出时,Dumpling 无法获知导出的表库信息,此时可以使用 --output-filename-template 选项来指定 CSV 文件的文件名格式,以方便后续使用 TiDB Lightning 导入数据文件。例如 --output-filename-template='test.sbtest1.{{.Index}}' 指定导出的 CSV 文件为 test.sbtest1.000000000、test.sbtest1.000000001 等。

你可以使用 --csv-separator、--csv-delimiter 等选项,配置 CSV 文件的格式。具体信息可查阅 (https://docs.pingcap.com/zh/tidb/stable/dumpling-overview#dumpling-%E4%B8%BB%E8%A6%81%E9%80%89%E9%A1%B9%E8%A1%A8)

注意
Dumpling 导出不区分字符串与关键字。如果导入的数据是 Boolean 类型的 true 和 false,导出时会被转换为 1 和 0 。