第25章 数据导入与导出
GUI 工具 导入与导出
TablePlus 支持从 CSV、JSON 和 SQL dump 文件导入数据,也可将表、视图和查询结果导出为 CSV、JSON、SQL 或 Excel 文件。
导入数据
有两种方式打开导入向导:
- 从菜单 File > Import 选择 From CSV...、From JSON... 或 From SQL Dump... - 在左侧边栏右键点击某个表,选择 Import > From CSV...、From JSON... 或 From SQL Dump... 从某个表开始导入时,向导会自动将该表选为目标表。
从左侧边栏导入
导入 CSV 或 JSON 文件前,请先选中一个数据库。
从 CSV 导入
选择文件后,导入 CSV 向导会在底部显示文件的前 100 行,上方则是列映射区域。可设置以下选项:
- Delimiter:分隔符,支持逗号、分号、Tab 或自定义分隔符。 - Quote:引号符,支持双引号、单引号或自定义字符。 - Encoding:文件编码,如 utf8(默认)、macOSRoman 或 windowsCP1252。 - First line is header:将第一行作为列名而非数据。 - Table:目标表。 - Create new table:不导入现有表,而是以文件名新建一个表。可让 TablePlus 自动检测列的数据类型,或将所有列都创建为 text 类型。 - Matching strategy:CSV 列与表列的匹配方式,可按名称和顺序、按名称或按顺序匹配,名称匹配还可选择是否区分大小写。 - Insert option(仅限 PostgreSQL、MySQL 和 MariaDB):当某行与现有键冲突时的处理方式:STOP ON ERROR、UPDATE ON DUPLICATE 或 REPLACE(仅 MySQL 和 MariaDB)。
要修改某一列的映射,点击该列上方的单元格,然后选择目标列、数据类型(新建表时)或 Do not import。
点击 Import 开始导入。
导入 CSV 向导
从 JSON 导入
导入 JSON 向导的用法与 CSV 向导类似:它会预览文件的前 100 条记录,并允许你选择编码、目标表(或新建表)、匹配策略和插入选项。
从 SQL dump 导入
导入 SQL 向导会预览文件的前 100,000 个字符。选择文件编码后点击 Import,即可在当前数据库上执行这些语句。
导入 SQL 向导
如需恢复用 pg_dump 或 mysqldump 生成的完整备份,请改用 Backup & Restore 功能。
导出数据
导出当前数据库中的表和视图:
1. 在左侧边栏选中一个或多个项目。 2. 进入 File > Export > Export Tables...(⌘ + Shift + E),或右键点击所选项目,选择 Export > Export Tables... 3. 在导出窗口中勾选要导出的项目。你可以切换 schema,跨多个 schema 勾选。 4. 选择格式标签页:CSV、JSON、SQL 或 EXCEL,并设置相应选项。 5. 点击 Export...,选择保存位置并确认。
导出表
对于 CSV、JSON 和 Excel 格式,TablePlus 会创建一个文件夹,每张表或视图对应一个文件。对于 SQL 格式,则会将所有项目写入同一个 .sql 文件。
File name 字段显示导出文件的默认名称。点击 Customize 可以基于连接名、数据库名、表名、标签以及日期时间等模式自定义文件名。
格式选项
格式 | 选项
CSV | Delimiter(分隔符)、Swap(引号符)、Line break(换行符)、Decimal separator(小数点符号)、Convert NULL to EMPTY(NULL 转为空值)、Convert line break to space(换行符转为空格)、Put field names in the first row(首行写入字段名)
JSON | 将行导出为 JSON 对象数组
SQL | 对每个项目可选择是否包含 Structure(表结构)、Drop statement(DROP 语句)和 Data(数据)。勾选 Compress the file using Gzip 会生成 .gz 压缩文件。
EXCEL | 每张表导出为一个 .xlsx 工作簿
导出为 SQL
按所选列导出表
如果只想导出某张表的部分列,右键点击该表并选择 Export > Export this Table with Column Selection... 在弹出的窗口中可以选择要导出的字段;对于 SQL 格式,还可以选择是否包含表结构、表内容以及 DROP TABLE IF EXISTS 语句。
如果要导出的是查询结果,请参见“使用查询结果”一章。
在后台运行导入和导出
导入或导出任务运行时,进度窗口中有 Import in Background 或 Export in Background 按钮。点击后即可关闭进度窗口,继续在主界面工作。任务会转入工具栏的 Notifications 按钮,你可以随时查看进度或停止任务;任务完成后还可以点击 Open Folder 在 Finder 中打开导出文件。
通知弹窗中的导入和导出任务