跳转到正文

DuckDB 客户端

打开 DuckDB 数据库,或用 SQL 查询 Parquet、CSV 和 JSON 文件,无需运行数据库服务器。

概览

查询语言
SQL
驱动
首次使用时下载
连接方式
文件
内置引擎
DuckDB 1.5.2
Mac 上的 TablePro 打开了一个 DuckDB 数据库,正在用 SQL 查询 Parquet 文件。

打开文件

打开 .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。

    适用于 iPhone 和 iPad 的 TablePro

  • 限制

    • 连接打开期间,一个 DuckDB 文件同时只允许一个进程写入。
    • 驱动包含核心功能、JSON、Parquet、ICU 和自动补全扩展。httpfs 等其他扩展会在查询首次需要时从 DuckDB 下载。
    • 通过 Quack 的远程连接为实验性功能。
  • TablePro 使用哪个 DuckDB 版本?

    DuckDB 1.5.2,编译在驱动中,不依赖您安装的任何 DuckDB。

  • CSV 文件应在 DuckDB 中打开,还是在 Data Files 窗口中打开?

    要浏览文件、清理数据并保存回去,请使用 Data Files 窗口。要在 SQL 中将它与其他文件或表联接,请用 DuckDB 打开;在那里文件保持只读。

获取 TablePro

本页功能全部免费。