成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Cloudflare D1 SQLite 与 Workers 接入简报

按托管 SQLite 语义、Workers/HTTP 访问、Time Travel 与只读副本,整理 D1 接入简报;不代持 API Token、不代删生产库。

场景说明

面向独立开发者:把「在 Workers 旁挂上 serverless SQL」写成可对账步骤,区别于 Cloudflare Workers Cron 与通用对象存储。

案例叙事

01他们做了什么

在 Cloudflare Workers 上做带持久状态的小应用时,常见卡点是:误把 KV/R2 当关系库用,或不知道备份与就近读该怎么选。

Cloudflare Docs《D1》Overview(Last updated / dateModified 可核)说明:D1 是 Cloudflare 托管的 serverless 数据库,具备 SQLite 的 SQL 语义、内置灾难恢复,以及 Worker 与 HTTP API 访问。支持为用户、租户或项目创建分离的数据库;Workers Paid 计划含一定数量数据库,超出按库计月费,并另有查询与存储费用。可按 Get started 创建首个库、导入数据,并从 Workers 或 Pages 查询。特性包括:用 D1 Client API 执行兼容 SQLite 的 SQL;Time Travel 作为备份与时间点恢复方式,可恢复到过去 30 天内任一分钟;全球只读复制可通过只读副本降低读延迟并扩展读吞吐。相关产品指向 Workers 与 Pages。本场景据此输出 D1 接入简报。禁止回显 API Token 或声称「生产库已建好」。

02实际效果

  • 源未披露量化「查询延迟下降」;公开文只描述 SQLite 语义、分库、Time Travel 与只读副本能力。
  • 能把「该用 D1 却用了 KV / 无恢复预期 / 与 Cron Trigger 混淆」拆开。
  • 为 Workers 旁路 SQL 提供可落地的选型与验收提问。

03值得知道

  • 具体定价、库数量上限与 SQL 限制以 Pricing/Limits 页为准;本条一手源是总览。
  • Time Travel 窗口与恢复操作以 Time Travel 专页为准。
  • 上面写的是产品能力说明,不是你账户下现有 D1 列表。

04可复制提示词

Cloudflare D1 接入简报

你是 Cloudflare D1 助手。只给 SQLite/Workers 接入核对简报,不要编造已建库成功。

应用形态:{{app_shape}}
是否按租户分库:{{per_tenant}}
读写/备份诉求:{{needs}}
现有 Workers/Pages:{{has_worker}}

输出 Markdown:
1. D1 vs KV/R2 选型提问
2. 绑定与首迁步骤提纲
3. Time Travel / 只读副本是否需要
4. 非生产验收
禁止索要 API Token;禁止代删生产数据库。

D1 查询失败/恢复演练提纲

Workers 调 D1 报错或需要演练恢复,请写提纲。

报错摘要:{{error}}
是否刚改 schema:{{schema_changed}}
恢复目标时间点:{{pitr_target}}

输出:
1. 绑定/权限/SQL 兼容性优先查什么
2. Time Travel 适用边界
3. 是否应先在副本/非生产验证
4. 下一步人工操作
不要伪造「已恢复到某分钟」。

05一手来源

Cloudflare Documentation · D1 Overview ↗

文档更新

怎么做

  1. 粘贴是否已有 Workers/Pages 项目、数据模型规模、是否需要按租户分库,以及读写延迟/备份诉求
  2. Agent 按官方 D1 Overview 要点输出:SQLite 语义与绑定→分库上限认知→Time Travel / 只读副本提问清单
  3. 人工按 Get started 建库与绑定;Agent 不代持账户 Token、不代执行生产 DROP

实用提示

  • D1 是带 SQLite SQL 语义的托管 serverless 数据库,可从 Workers/Pages 与 HTTP API 访问,并支持按用户/租户/项目分库
  • 与 cloudflare-workers-cron-trigger-brief 不同:本条是 SQL 存储面,不是定时触发 Worker
#Cloudflare#D1#SQLite#Workers#独立开发者