適用於 Mac 的 Cloudflare D1 用戶端
從一個連線存取 Cloudflare 帳號中的 D1 資料庫,透過 Cloudflare API 使用 SQLite 方言查詢,並在 Structure 分頁管理資料表、索引和觸發程序。
適用於 Mac首次選擇 Cloudflare D1 時下載驅動程式
概覽
- 查詢語言
- SQL
- 驅動程式
- 首次使用時下載
- 連線方式
- 服務 API
- iPhone 與 iPad
- 無法開啟
使用 API 權杖連線
D1 連線需要三個值:資料庫名稱或 UUID、Cloudflare 帳號 ID 和 API 權杖。權杖填入 API Token 欄位,儲存在 macOS 鑰匙圈。所有請求經 HTTPS 傳送至 Cloudflare API,因此沒有主機、連接埠、SSL 設定或 SSH 通道。
透過 Custom token 範本建立含 Account > D1 > Edit 權限的權杖,Cloudflare 僅顯示一次,請及時複製。權杖可存取帳號中所有 D1 資料庫,不僅是目前連線的資料庫。
匯入 d1://account-id/database-name URL 會填入帳號和資料庫;權杖從不包含在 URL 中,需隨後貼上。
切換資料庫並查詢
工具列資料庫切換器列出帳號的 D1 資料庫,無須重新連線即可切換,也可建立和刪除資料庫。各分頁保持在開啟時的資料庫。
查詢使用 SQLite 方言。EXPLAIN QUERY PLAN 繪製為圖形,列編輯在格線中暫存至儲存,Preview SQL 先顯示陳述式。
請讓每個陳述式獨立成立:一個陳述式設定的 PRAGMA 或暫存資料表在下一個時消失,每個執行即提交,無法復原。Cloudflare 限流時,錯誤包含重試前要求等待的時間。
資料表、索引與觸發程序
Structure 分頁 可建立和刪除資料表、新增和刪除欄位、建立和刪除索引,包括含 WHERE 條件的部分索引;Preview SQL 在儲存前顯示 DDL。Triggers 分頁可建立、編輯和刪除觸發程序,資料表可從側欄重新命名。
調整欄位順序或修改外部索引鍵需要重建資料表。在 D1 上每個陳述式都是獨立請求,無法用交易將重建合併,TablePro 只產生重建指令碼供自行執行。
移動資料
TablePro 不提供 D1 匯入。用 wrangler d1 execute 的 --file 選項載入 SQL 檔案,再在此瀏覽結果。匯出將 D1 資料表或查詢結果寫為 CSV、JSON、SQL、XLSX、Markdown、HTML與XML。
iPhone 與 iPad
iPhone 與 iPad App 沒有 Cloudflare D1 驅動程式。從 Mac 同步的 Cloudflare D1 連線會顯示在清單中,但無法開啟。
限制
- 每個陳述式都是獨立 HTTP 請求,不保留工作階段狀態,也不支援交易。
關於 Cloudflare D1 的問題
使用 D1 的 Sessions API 嗎?
不使用。每個陳述式作為獨立請求傳送,無工作階段或書籤,因此無論同一分頁或跨分頁,陳述式間都不保留狀態。
需要安裝 Wrangler 嗎?
瀏覽、查詢和編輯不需要,TablePro 直接與 Cloudflare API 通訊。僅載入 SQL 檔案需要 Wrangler,因為 TablePro 不提供 D1 匯入。
取得 TablePro
需要 macOS 13 Ventura 或更新版本