跳转到正文

每天都用 TablePro?购买许可证即可使用付费功能,并支持下个版本的开发。 购买许可证购买许可证,支持 TablePro

适用于 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 应用没有 Cloudflare D1 驱动。从 Mac 同步的 Cloudflare D1 连接会显示在列表中,但无法打开。

限制

  • 每条语句都是独立 HTTP 请求,不保留会话状态,也不支持事务。

关于 Cloudflare D1 的问题

使用 D1 的 Sessions API 吗?

不使用。每条语句作为独立请求发送,无会话或书签,因此无论同一标签页或跨标签页,语句间都不保留状态。

需要安装 Wrangler 吗?

浏览、查询和编辑不需要,TablePro 直接与 Cloudflare API 通信。仅加载 SQL 文件需要 Wrangler,因为 TablePro 不提供 D1 导入。

获取 TablePro

Mac 应用可免费下载和使用。Starter 或 Team 方案添加可选功能。
下载 Mac 版

需要 macOS 13 Ventura 或更新版本