SuperAPI AI 工具集

cloudflare-d1

部署与运维

查看项目

更新于 10-16 05:45

技能介绍

用途:Cloudflare D1 是构建在 SQLite 之上的托管无服务器 SQL 数据库,主要用于 Cloudflare Workers 与 Pages Functions 应用的数据存储,通过绑定(binding)在运行时访问。

主要能力:通过 wrangler 命令创建、执行 SQL、导出、管理迁移与 Time Travel 恢复。运行时核心 API 包括 prepare、batch、exec、withSession;预编译语句支持 bind 占位符,batch 可原子执行多条语句,失败则回滚。支持读复制(Sessions API,bookmark 参数 first-unconstrained / first-primary)、JSON 查询、生成列、外键、索引。

用法:常用命令如 npx wrangler d1 create my-database、npx wrangler d1 execute my-database --remote --command="SELECT 1"、npx wrangler d1 migrations create/apply、npx wrangler d1 export、npx wrangler d1 time-travel info/restore。在 wrangler.jsonc 中配置 d1_databases 绑定,Workers 中通过 env.DB 访问,Pages 需在设置中绑定。本地开发用 --local 或 wrangler dev。

适用场景:Workers/Pages 全栈应用的数据层、需要 SQLite 语义的轻量服务、读多写少且可接受最终一致的读取复制场景。限制与注意:单库付费 10 GB/免费 500 MB,单行最大 2 MB,SQL 语句最大 100 KB,绑定参数上限 100,单次调用查询数付费 1000/免费 50;Time Travel 付费 30 天/免费 7 天,恢复会原地覆盖数据库;jurisdiction 创建后不可更改;exec() 不可用于用户输入(无参数化);避免长事务。计费、限额、定价细节以资料所列为准,更多配置以 references 各文件为准。