适用于 Mac、iPhone和iPad 的 DuckDB 客户端
打开 DuckDB 数据库文件,或指向 Parquet、CSV、JSON 文件,在原位置使用 SQL 查询。DuckDB 在驱动中运行,除非主动连接服务器,否则无需运行服务器。
适用于 Mac、iPhone和iPad首次选择 DuckDB 时下载驱动


概览
- 查询语言
- SQL
- 驱动
- 首次使用时下载
- 连接方式
- 文件
- 内置引擎
- DuckDB 1.5.2
- iPhone 和 iPad
- 可打开
打开文件
选择 .duckdb 或 .ddb 文件,或输入尚不存在的路径来创建。输入 :memory: 可创建仅在会话期间存在的数据库。DuckDB 在文件开头字节中标识格式,因此无论文件名如何均可识别并打开。
选择 .parquet、.csv、.tsv、.json 或 .ndjson,会在内存数据库中作为只读视图打开,一个名为 file,另一个以文件名命名。磁盘文件保持逐字节不变;要修改内容,请在 .duckdb 数据库中从文件创建表。
在 Finder 双击 .duckdb 即可在此打开。Parquet 文件的“打开方式”列出 TablePro,通过 File > Open File 选择 Parquet 会打开为 DuckDB 连接,而非进入 Data Files 窗口。
Remote (Quack, experimental) 连接由 quack_serve 启动的 DuckDB 服务器,并以 remotedb 等别名挂载,通过该别名访问表。首次远程连接从 DuckDB 下载 quack 扩展。
查询和编辑
任何连接都可从 SQL 直接读取文件,例如 SELECT * FROM 'data.csv' 或 read_parquet('events.parquet')。ATTACH 其他 DuckDB 文件会作为第二个数据库加入侧栏,Cmd+K 无需重连即可切换。重新连接后 DuckDB 不保留任何挂载。
EXPLAIN 绘制为计划图。编辑表中的行时,Preview SQL 先显示每条语句,数据文件上的视图保持只读。
结构
Structure 标签页 编辑表并在执行前显示 DDL。此处数据库为文件,因此不能从应用创建或删除数据库;访问第二个文件请用 ATTACH。
共享文件并备份
TablePro 持有文件时,duckdb CLI、notebook 或 dbt 无法打开。设置 Release the File Lock After 可在空闲数分钟后释放,下次查询再获取;Open the File Read-Only 允许多个读取者共享。Database > Release File Lock 立即释放并保留标签页。会话若持有未结束事务、临时表、挂载数据库或已修改设置,会拒绝释放并说明原因。
Server Dashboard 显示数据库大小、块大小、总块数、内存上限和线程数。
Backup Dump 无需安装,因为 DuckDB 通过已打开连接写入。可选择供日后在 TablePro 还原的 .duckdb 文件,或含 schema.sql、load.sql 及每表一个 Parquet 文件的文件夹,pandas、Spark 和 BigQuery 可直接读取。Restore Dump 在首个名称已被占用的对象处停止。
移动数据
导入支持 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。Remote (Quack) 连接仅支持 Mac。
限制
- 连接打开期间,一个 DuckDB 文件同时只允许一个进程写入。
- 驱动包含核心功能、JSON、Parquet、ICU 和自动补全扩展。httpfs 等其他扩展会在查询首次需要时从 DuckDB 下载。
- 通过 Quack 的远程连接为实验性功能。
关于 DuckDB 的问题
使用哪个 DuckDB 版本?
DuckDB 1.5.2,编译在驱动中,不依赖已安装的任何 DuckDB。
CSV 应在 DuckDB 还是 Data Files 窗口打开?
浏览、清理并保存回文件,请在 Data Files 窗口打开。要用 SQL 与其他文件或表联接,则用 DuckDB 打开,文件保持只读。
获取 TablePro
需要 macOS 13 Ventura 或更新版本