// 免費工具

SQLite 連線字串產生器

為 Microsoft.Data.Sqlite、JDBC、SQLAlchemy、Python 和 Node 以檔案路徑建立 SQLite 連線字串,或貼上 URI、檔名或 Data Source 字串,看看每個選項的作用。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。

在 SQLly 中開啟此連線

開啟 SQLly 的連線編輯器,並自動填入內容。

設計即私密。 建構器和解碼器都是在此分頁中執行的純 JavaScript。頁面不會發送你輸入的任何請求,也不會儲存任何資料(甚至不在你的瀏覽器中),載入後可離線使用。開啟 SQLly 的連結會從你的瀏覽器直接進入你電腦上的應用程式。

SQLite 連線字串格式

SQLite 的「連線字串」其實大多是檔案路徑,但每個 wrapper 的寫法都不一樣: Data Source=app.db 在 .NET 中, jdbc:sqlite:/path 在 Java 中, sqlite:////abs/path.db (四個斜線),這是 SQLAlchemy 中的寫法。SQLite 自己的 URI 檔名 (file:app.db?mode=ro)可新增唯讀模式等選項,但僅在呼叫端啟用 URI 處理時有效。

檔案路徑 sqlite3 CLI、大多數驅動程式、SQLly

/var/data/app.db

URI 檔名(唯讀) SQLite URI 檔名

file:///var/data/app.db?mode=ro

ADO.NET Microsoft.Data.Sqlite, EF Core

Data Source=/var/data/app.db;Mode=ReadOnly

JDBC xerial sqlite-jdbc

jdbc:sqlite:/var/data/app.db

SQLAlchemy URL Python SQLAlchemy

sqlite:////var/data/app.db

預留位置,例如 your_password 就只是這個意思:用上面的表單組出你自己的字串。更多關於把 SQLly 連上 SQLite 的說明: 適用於 SQLite 的 SQLly.

SQLite URI 檔名參數

其配置為 file:;授權(authority)部分必須為空或 localhost,因此 file:/abs/path, file:///abs/path 和 file://localhost/abs/path 都是相同的檔案。在路徑中編碼 ? 作為 %3F 和 # 作為 %23 在路徑中。URI 處理預設為關閉:請使用 SQLITE_OPEN_URI, uri=True 在 Python 中,或你的包裝函式裡的對應功能。

關鍵字同義詞預設其作用
mode - rwc ro 唯讀, rw 可讀寫(必須存在), rwc 可讀寫-可建立, memory 記憶體內。
cache - 私有 shared 允許同一處理程序中的連線共用快取。
immutable - 0 1 承諾檔案永遠不會改變:完全不加鎖。如果有人進行寫入,會發生讀取損壞。
nolock - 0 1 停用檔案鎖定。
vfs - 預設 VFS 要使用的 VFS 模組名稱。
psow - 建置預設值 斷電安全覆寫。

Microsoft.Data.Sqlite 關鍵字

ADO.NET 風格。資料源也可以是 URI 文件名。

關鍵字同義詞預設其作用
Data Source DataSource, Filename 空的(暫存磁碟資料庫) 檔案路徑, :memory:,或 URI 檔名。
Mode - 讀寫建立 ReadWriteCreate, ReadWrite, ReadOnly, Memory.
Cache - 預設 Default, Private, Shared.
Password - - 發送 PRAGMA key;需要支援加密的版本,例如 SQLCipher。
Foreign Keys - 空的(無 pragma) True 會開啟 PRAGMA foreign_keys.
Recursive Triggers - 假 PRAGMA recursive_triggers.
Default Timeout 命令逾時 30 6.0+。單位為秒;也是在資料庫被鎖住時的等待時間。
Pooling - 真 6.0+。連線集區。

常見的 SQLite 連線錯誤

unable to open database file

原因: SQLITE_CANTOPEN:目錄不存在、處理程序無法寫入該目錄(SQLite 需要在資料庫旁建立日誌檔)、相對路徑被解析到預期外的工作目錄,或 ~ 被使用(SQLite 不會展開它)。

修正此問題: 使用絕對路徑、建立目錄,並給予處理程序該目錄的寫入權限,而不只是檔案。

database is locked

原因: SQLITE_BUSY:另一條連線持有寫入鎖,而這條連線等得不夠久。

修正此問題: 設定忙碌逾時(Default Timeout 在 Microsoft.Data.Sqlite 中, timeout 在 Python 中, busy_timeout pragma),讓寫入交易保持簡短,並考慮 PRAGMA journal_mode=WAL 用於並行讀取。

attempt to write a readonly database

原因: 檔案或其所在目錄對這個處理程序而言是唯讀,或者檔案是以 mode=ro / Mode=ReadOnly.

修正此問題: 修正檔案及其目錄的權限,或以讀寫模式開啟。

file is not a database

原因: SQLITE_NOTADB:檔案不是 SQLite(例如 DuckDB 檔案)、是用你未提供的金鑰加密,或是已損毀。

修正此問題: 檢查該檔案是什麼(file app.db 在 macOS/Linux 上)並使用正確的引擎或金鑰開啟它。

SQLite 連線字串常見問題

什麼是 SQLite 連線字串?

通常只需檔案路徑。在 .NET 中是 Data Source=/path/app.db,在 Java 中是 jdbc:sqlite:/path/app.db,在 SQLAlchemy 中是 sqlite:////path/app.db 對於絕對路徑(sqlite:///app.db 對於相對路徑)。

如何以唯讀方式開啟 SQLite 資料庫?

使用 URI 檔名並搭配 mode=ro (file:/path/app.db?mode=ro,並啟用 URI 處理), Mode=ReadOnly 在 Microsoft.Data.Sqlite 中, open_mode=1 在 sqlite-jdbc 中,或者 readonly: true 在 better-sqlite3 中。

如何建立記憶體內的 SQLite 資料庫?

使用 :memory: 作為路徑。每個連線都會獲得自己的私有資料庫,除非你使用共用快取 URI,例如 file::memory:?cache=shared.

為什麼 SQLAlchemy SQLite URL 中有四個斜線?

sqlite:// 是協定和空主機,第三個斜線結束主機部分,其餘的是路徑。絕對路徑以自己的斜線開始,所以 /var/data/app.db 變成 sqlite:////var/data/app.db.

// 完全跳過字串

連線一次。然後只需撰寫 SQL。

SQLly 是適用於 macOS、Windows 和 Linux 的原生 SQL 工作台。把連線字串貼進連線編輯器,密碼存在系統鑰匙圈裡,就能在 SQLite 及更多引擎上獲得結構描述感知的 IntelliSense。