// 免費工具

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 的說明: 適用於 DuckDB 的 SQLly.

開啟 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。