// 免费工具

DuckDB 连接字符串生成器

DuckDB 在你的进程中运行并打开文件,因此它的“连接字符串”就是一个路径。为数据库文件(只读或内存模式)生成 JDBC URL、Python 调用、SQLAlchemy URL 和 CLI 命令。 所有操作都在你的浏览器中运行:你输入的内容不会被发送到任何地方。

在 SQLly 中打开此连接

打开 SQLly 的连接编辑器并自动填入内容。

从设计上保护隐私。 构建器和解码器是运行在此标签页中的纯 JavaScript。页面不会把你输入的内容发送给任何服务器,不存储任何内容(甚至不存入浏览器),一旦加载完毕即可离线继续工作。“在 SQLly 中打开”链接会直接从浏览器跳转到你电脑上的应用。

DuckDB 连接字符串格式

每个 DuckDB 客户端都会打开一个数据库文件路径,或者 :memory: 用于临时的内存数据库。同一时间只有一个进程能以读写方式打开文件,多个进程则可以只读方式共享它。

文件路径 每个客户端,SQLly

/var/data/analytics.duckdb

JDBC DuckDB JDBC 驱动

jdbc:duckdb:/var/data/analytics.duckdb

SQLAlchemy URL duckdb-engine

duckdb:////var/data/analytics.duckdb

CLI,只读 duckdb

duckdb -readonly /var/data/analytics.duckdb

占位符,例如 your_password 就是这样:用上面的表单自己拼一个连接字符串即可。更多关于将 SQLly 连接到 DuckDB 的信息: SQLly 适用于 DuckDB.

打开 DuckDB 数据库

只读模式允许多个进程读取同一文件。

关键字同义词默认作用
JDBC - jdbc:duckdb:(内存中) jdbc:duckdb:/path/file.duckdb;借助 duckdb.read_only=true 连接属性。设置项可以用分号跟在后面: jdbc:duckdb:/path;threads=4.
Python - :memory: duckdb.connect("file.duckdb", read_only=True).
SQLAlchemy - - duckdb:///relative.duckdb, duckdb:////abs/path.duckdb, duckdb:///:memory:;通过 connect_args={"read_only": True}.
CLI - 内存中 duckdb file.duckdb;添加 -readonly 则以只读方式打开。
Node.js - - @duckdb/node-api: await DuckDBInstance.create("file.duckdb").

常见的 DuckDB 连接错误

IO Error: Could not set lock on file "analytics.duckdb": Conflicting lock is held

原因: 另一个进程已以读写方式打开了该文件(通常是某个笔记本应用、一个命令行会话或第二个应用实例)。

修复: 关闭另一个进程;如果两者都不需要写入,也可以都以只读方式打开。

IO Error: Cannot open database "analytics.duckdb" in read-only mode: database does not exist

原因: 只读模式不会创建文件,而路径有误,或相对于一个意料之外的工作目录。

修复: 使用指向现有数据库的绝对路径。

DuckDB 连接字符串常见问题

DuckDB 有连接字符串吗?

不是客户端/服务器那种模式:DuckDB 是嵌入式的,所以你打开的是一个文件路径(或 :memory:)。包装方式有所不同: jdbc:duckdb:/path 在 Java 中, duckdb:///path 在 SQLAlchemy 中使用,Python、Node 和 CLI 中则是普通路径。

如何以只读方式打开 DuckDB 文件?

read_only=True 在 Python 中, duckdb.read_only=true JDBC 中的属性, connect_args={"read_only": True} 在 SQLAlchemy 中,或者 duckdb -readonly file.duckdb 在 CLI 中。

两个程序可以使用同一个 DuckDB 文件吗?

同一时刻只能有一个进程以读写方式打开它;多个进程可以同时以只读方式打开。

// 完全跳过这些字符串

连接一次。之后只管写 SQL。

SQLly 是适用于 macOS、Windows 和 Linux 的原生 SQL 工作台。在连接编辑器中粘贴连接字符串,把密码保存在系统钥匙串里,并在 DuckDB 等引擎上获得模式感知的 IntelliSense。