DuckDB 連線字串產生器
DuckDB 在你的程序內執行並開啟檔案,所以它的「連線字串」就是一個路徑。為資料庫檔案產生 JDBC URL、Python 呼叫、SQLAlchemy URL 和 CLI 指令,支援唯讀或記憶體資料庫。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。
在 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。