適用於 Mac 的 Turso、libSQL 用戶端

連線類型選擇 Turso，Connection Mode 保持 Remote (Turso)。貼上以 .turso.io 結尾的資料庫 HTTPS URL，將權杖填入 API Token，儲存在 macOS 鑰匙圈。Turso 儀表板可取得兩者，也可用 turso db show my-db --url、turso db tokens create my-db。

libsql:// URL 會改寫為 HTTPS，匯入後建立遠端連線。URL 指定單一資料庫，因此無主機、連接埠或資料庫欄位。使用 HTTPS 而非明文 HTTP 時連線加密，不提供 SSH 通道。

libSQL 使用 SQLite 語法，瀏覽、EXPLAIN QUERY PLAN 圖、含 Preview SQL 的暫存編輯和匯出與 SQLite 相同。

遠端連線不執行交易。每個陳述式為獨立 HTTP 請求並各自提交，BEGIN 會報錯「Transactions are not supported in this mode」。交易工作需使用 libSQL 一節介紹的本機檔案。

遠端模式不載入 SQLite 擴充功能，Turso 資料庫執行伺服器建置時包含的擴充功能。Turso 限流時，錯誤說明重試前需等待多少秒。

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

遠端資料庫調整欄位順序或修改外部索引鍵時，TablePro 產生重建指令碼供自行檢閱執行。重建需要跨多個 HTTP 請求的單一交易，因此不能代為執行。

TablePro 不提供 Turso、libSQL 匯入；請用 Turso CLI 或 sqld 伺服器的匯入功能載入。要取出資料，可將資料表或查詢結果匯出為 CSV、JSON、SQL、XLSX、Markdown、HTML與XML。

iPhone 與 iPad App 沒有 Turso 驅動程式。從 Mac 同步的 Turso 連線會顯示在清單中，但無法開啟。

首次使用時下載iPhone 與 iPad: 無法開啟

自行託管 sqld 或此 Mac 上的檔案請選擇 libSQL。Remote 模式可存取任何提供 Hrana v2 pipeline 端點的 sqld，包括預設接聽 8080 連接埠的本機伺服器。未使用 --auth-jwt-key-file 啟動的伺服器可留空權杖，否則提供符合伺服器金鑰的 JWT。

Local File 使用驅動程式內建 SQLite 開啟 libSQL 檔案，不存在的路徑連同檔案夾一起建立。本機檔案支援交易、從連線 Extensions 清單載入 SQLite 擴充功能，並在確認後執行欄位重排或外部索引鍵重建。

ALTER TABLE … ALTER COLUMN 等僅 libSQL 理解的陳述式，在本機檔案上會失敗，因為執行者是 SQLite。加密 libSQL 檔案無法開啟。切勿開啟執行中的 App 正在作為 Turso 嵌入式複本同步的檔案，兩個程式同時存取可能導致損毀。

Backup Dump 和 Restore Dump 對本機 libSQL 檔案執行 sqlite3。

libSQL 設定指南 （英文）↗