跳至主要內容

Turso 與 libSQL 用戶端

以 URL 和權杖連線至 Turso 資料庫,或開啟 libSQL 檔案,並以 SQLite 語法查詢。

概覽

查詢語言
SQL
驅動程式
首次使用時下載與 libSQL 共用
連線方式
服務 API

連線至 Turso

在 連線模式 (Connection Mode) 中選擇 遠端 (Turso) (Remote (Turso)),然後貼上資料庫的 HTTPS URL 和 API Token,權杖會存放在 macOS 鑰匙圈中。兩者都可從 Turso 主控台或 CLI 取得。

匯入的 libsql:// URL 會成為 HTTPS 遠端連線,每個 URL 指定一個資料庫。一般 HTTP URL 未加密,也不提供 SSH 通道。

查詢與編輯

libSQL 使用 SQLite 的語法,因此瀏覽、EXPLAIN QUERY PLAN 圖表和匯出的行為與 SQLite 相同。

遠端連線不執行交易:每個陳述式都是獨立的 HTTP 請求並各自提交,BEGIN 會失敗並顯示「Transactions are not supported in this mode」。交易需要以 libSQL 開啟的本機檔案。遠端模式不載入 SQLite 擴充功能,因為 Turso 資料庫會執行其伺服器建置時所含的擴充功能;被節流的請求,其錯誤會說明需要等待幾秒。

資料表、索引與觸發程序

Structure 分頁可建立資料表,新增和刪除欄位及索引,並建立、編輯和刪除觸發程序。可從側邊欄重新命名資料表,但不能重新命名檢視表。

遠端的欄位重新排序或外部索引鍵變更會產生重建指令碼,供您檢查並執行,因為 TablePro 無法將多個獨立的 HTTP 請求放在同一個交易中。

本頁介紹 Turso 專屬的功能。Safe Mode、AI 助理、MCP 伺服器和 TablePro 的其他功能請見功能頁面。

libSQL

自行託管的 sqld 伺服器(透過其 Hrana v2 pipeline 端點存取),或這台 Mac 上以 本機檔案 (Local File) 模式開啟的檔案,請選擇 libSQL。本機檔案支援交易、載入 SQLite 擴充功能,並在您確認後執行重建指令碼,Backup Dump 和 Restore Dump 會對其執行 sqlite3。

切勿開啟執行中的 App 正作為 Turso 嵌入式複本同步的檔案:兩個程式同時存取可能導致檔案損毀。

限制
  • Backup Dump 僅支援本機 libSQL 檔案,不支援遠端資料庫。

其他

  • 搬移資料

    將資料表或查詢結果匯出為 CSV、JSON、SQL、XLSX、Markdown、HTML 與 XML。要載入資料,請使用 Turso CLI 或 sqld 伺服器上的匯入功能。

  • 限制

    • 每個連線對應一個資料庫,不支援切換資料庫或分支。
    • 不支援內嵌複本。本機檔案獨立開啟,不會同步。
  • 應該選 Remote 還是 Local File?

    透過 URL 存取的 Turso 資料庫或 sqld 伺服器請選 Remote。這台 Mac 上的 libSQL 檔案請選 Local File,它也提供交易、SQLite 擴充功能和備份。

  • 需要安裝 Turso CLI 嗎?

    不需要。Turso 主控台也會顯示資料庫 URL 並建立權杖。CLI 適合從終端機載入資料。

取得 TablePro

本頁功能全部免費。