// HTTP · SQLite 方言

適用於 Mac、Windows 和 Linux 的 libSQL 與 Turso GUI

使用 Turso Cloud 資料庫或你自己的 sqld 伺服器,體驗就跟 SQLite 一模一樣 - 同樣的方言、同樣的 IntelliSense、同樣的比較工具 - 用驗證權杖取代使用者名稱和密碼。

連線經由
HTTP(S) 連線 Turso Cloud 或自行架設的 sqld
預設連接埠
8080 用於 sqld;Turso 主機一律使用 HTTPS
登入
資料庫授權權杖;本機伺服器可不填
貼上 URL
libsql://…turso.io?authToken=…

SQLly 為 libSQL 和 Turso 做了什麼

libSQL 是透過網路存取的 SQLite——Turso Cloud,或 sqld 在你自己的機器上。SQLly 提供 SQLite 方言和工具,並且清楚指出網路伺服器與本機檔案在行為上的不同之處。

權杖登入,安全保管

貼上資料庫的驗證權杖 - 或是一個 libsql:// 帶有 ?authToken= - 而它會直接進入作業系統的安全儲存區,絕不寫入檔案。Turso 主機一律透過 HTTPS 連線。

TLS 與憑證 →

與 SQLite 方言完全一致

查詢以 SQLite 原生方言執行,每種儲存類別都如實呈現:64 位元整數保持精確、blob 保持二進位,每個欄位宣告的型別也都會擷取。

SQLite 在 SQLly →

腳本會作為一個整體執行

多陳述式指令碼會視為單一單位執行,因此 BEGIN … COMMIT 以及自動回滾安全設定都會發揮作用,第一個失敗的陳述式會以伺服器自己的訊息中止腳本。

自動回滾 →

比較並追蹤你的架構

結構描述比較、結構描述歷程快照與資料比較都能在 libSQL 上運作,測試資料產生器和結構編輯器也一樣——很適合用來讓 Turso 資料庫與本機 SQLite 檔案保持同步。

結構描述比較 →

執行計畫、儀表板與完整性檢查

預估計畫使用 SQLite 的 EXPLAIN QUERY PLAN,伺服器儀表板與磁碟使用量會讀取資料庫的頁面計數器,而維護提供 REINDEX 和完整性檢查(伺服器拒絕 VACUUM 和 ANALYZE).

查詢計畫 →

誠實面對取消與分頁

libSQL 伺服器無法中斷正在執行的陳述式,因此「取消」只能放棄請求;而且整個結果會在第一列出現之前就全部送達。遇到非常大的讀取時,請用 LIMIT 和 OFFSET.

查詢執行 →

連線到 Turso 或 libSQL 伺服器

  1. 下載 SQLly 適用於 macOS、Windows 或 Linux,從 下載頁面 下載並開啟它。
  2. 建立連線並選擇 libSQL / Turso。 連接埠預設為 8080,也就是 sqld 自己用的埠;Turso 主機則使用 HTTPS。
  3. 輸入主機 - 你的 …turso.io 位址,或者執行 sqld 的機器 - 或直接貼上一個 libsql:// URL,或一個普通的 http:// 或 https:// 端點。
  4. 貼上驗證權杖,如果本機伺服器沒有驗證,就留空。沒有使用者名稱或密碼。
  5. 測試、儲存並連線。 對於堡壘機後方的自架伺服器,SSH 通道、Proxy、Kubernetes 連接埠轉發與各種 TLS 模式都能正常運作。

libSQL / Turso 上的每個 SQLly 工具

這份引擎矩陣和應用程式用來啟用或停用選單的是同一份,所以在這裡看到的就是實際狀況。當某項工具不適用於 libSQL / Turso 時,應用程式會說明原因——我們也一樣。

SQLly 工具在 libSQL / Turso 上的支援情形
工具 libSQL / Turso
物件總管、IntelliSense 與暫留卡片 是
預估執行計畫 是 SQLite 的 EXPLAIN QUERY PLAN。
伺服器儀表板 是 資料庫的大小、空閒清單及內容。
磁碟使用量與物件瀏覽器 是
維護選單 是 重新索引和完整性檢查;伺服器拒絕 VACUUM 和 ANALYZE。
結構描述比較與結構描述歷程 是
資料比較 是
資料傳輸 是
測試資料產生器 是
資料表結構編輯器 是
SSH 通道、代理和 Kubernetes 連接埠轉發 是 適用於自行架設的伺服器。
唯讀連線 是
自動回滾安全封裝 是
在結果網格中編輯列 否 libSQL / Turso 尚不可用。
實際(已執行)計畫 否 libSQL 只公開 SQLite 的預估計畫。
活動監視器 否 libSQL 對每個請求各自服務;沒有工作階段清單。
查詢洞察 否 libSQL 沒有查詢統計資料存放區。
索引分析器 否 libSQL 不保留索引使用計數器。
安全性編輯器(使用者、角色、授權) 否 在 libSQL / Turso 上不可用。
備份 / 還原 否 使用 Turso 自身的備份,或複製 sqld 的資料目錄。
建立與刪除資料庫對話方塊 否 libSQL 資料庫是在伺服器上建立的。
程序模式 否 libSQL 沒有預存程序。
SQL Agent、Extended Events 與引導式設計工具 否 僅適用於 SQL Server 和 Azure SQL。

關於在 SQLly 中使用 libSQL / Turso 的問題

SQLly 支援 Turso Cloud 嗎?

可以。在連線編輯器中選擇 libSQL / Turso,輸入你的 …turso.io 主機並貼上資料庫的驗證權杖,或者貼上一個帶有 ?authToken= 的 libsql:// URL,SQLly 會自動填入所有資訊。該權杖會儲存在你的作業系統安全儲存中,Turso 主機總是透過 HTTPS 存取。

我可以在沒有權杖的情況下連線本機 sqld 伺服器嗎?

可以。沒有驗證的本機伺服器,驗證權杖留白即可;sqld 預設的連接埠 8080 會自動幫你填好。遠端自行託管的伺服器,SSH 通道、代理、Kubernetes 連接埠轉發和各種 TLS 模式全都可用。

交易可以透過 libSQL 運作嗎?

是的。含多個語句的指令碼會作為一個單位執行,因此 BEGIN … COMMIT 和自動復原的安全設定都能運作,第一個失敗的語句會以伺服器自己的訊息停止指令碼。

為什麼 SQLly 無法停止長時間執行的 libSQL 查詢?

libSQL 伺服器無法中斷正在執行的陳述式,因此「取消」只能放棄該請求。而且整個結果會在第一列出現前就送達,所以非常大的讀取請用 LIMIT 和 OFFSET 分頁讀取。

// 在你自己的 libSQL / Turso 上試試

把你的 libSQL / Turso 帶回小豬家

SQLly 在 macOS、Windows 和 Linux 上免費開始使用,不需要帳戶。