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