概览
- 查询语言
- SQL
- 驱动
- 首次使用时下载
- 连接方式
- 文件
- 内置引擎
- DuckDB 1.5.2


打开文件
打开 .duckdb 或 .ddb 文件(也可从 Finder 打开),输入新路径创建文件,或用 :memory: 创建临时数据库。文件按头部识别,而非扩展名。
Parquet、CSV、TSV、JSON 和 NDJSON 可通过 文件 > 打开文件 (File > Open File) 打开为名为 file 及以文件名命名的只读视图,源文件不会被更改。远程(Quack,实验性) (Remote (Quack, experimental)) 通过别名连接 quack_serve 服务器;首次连接会下载 DuckDB 的 quack 扩展。
查询和编辑
直接查询文件,例如 SELECT * FROM 'data.csv'。ATTACH 将另一个 DuckDB 文件加入侧边栏,⌘K 可在它们之间切换,直到下次重新连接。EXPLAIN 会绘制为计划图。
表中的行可以编辑,而数据文件上的视图保持只读:要编辑其数据,请在 DuckDB 数据库中创建表。没有创建或删除数据库的操作;连接时输入新路径即可创建文件。
共享文件并备份
TablePro 持有文件时,duckdb CLI、notebook 或 dbt 无法打开它。Release the File Lock After 会在空闲数分钟后释放文件,下次查询时再获取;Open the File Read-Only 允许多个读取者共享;数据库 > Release File Lock (Database > Release File Lock) 会立即释放。会话持有事务、临时表、附加数据库或已修改的设置时,会拒绝释放并说明原因。
Backup Dump 无需安装任何工具,因为 DuckDB 通过已打开的连接写入:可以是日后用于还原的 .duckdb 文件,也可以是包含 schema.sql、load.sql 及每表一个 Parquet 文件的文件夹,pandas、Spark 和 BigQuery 可直接读取。
本页介绍 DuckDB 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。
其他
移动数据
导入 CSV、TSV、JSON、JSONL、XLSX 和 SQL 文件,并将表和结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML。从 Settings > Plugins 安装的 Parquet 导出插件可添加 Parquet 输出,每表一个文件。
iPhone 和 iPad
iPhone 和 iPad 应用可连接 DuckDB。
iPhone 和 iPad 应用内置 DuckDB。在“文件”应用中选择的文件会在原位置打开,而不是作为副本;In-Memory 提供临时数据库。可以卡片形式浏览表,并在 Query 标签页运行 SQL。
限制
- 连接打开期间,一个 DuckDB 文件同时只允许一个进程写入。
- 驱动包含核心功能、JSON、Parquet、ICU 和自动补全扩展。httpfs 等其他扩展会在查询首次需要时从 DuckDB 下载。
- 通过 Quack 的远程连接为实验性功能。
TablePro 使用哪个 DuckDB 版本?
DuckDB 1.5.2,编译在驱动中,不依赖您安装的任何 DuckDB。
CSV 文件应在 DuckDB 中打开,还是在 Data Files 窗口中打开?
要浏览文件、清理数据并保存回去,请使用 Data Files 窗口。要在 SQL 中将它与其他文件或表联接,请用 DuckDB 打开;在那里文件保持只读。