SuperAPI AI 工具集

cloudflare-d1

数据与分析

查看项目

更新于 10-16 03:14

技能介绍

用途:在 Cloudflare 边缘构建无服务器 SQLite 数据库应用,涵盖建库、SQL 迁移、从 Workers 查询与本地/远程开发。

主要能力:通过 wrangler 创建和管理数据库;使用迁移文件做版本化 schema 变更,迁移按顺序执行且事务化回滚;在 Worker 中以绑定 env.DB 访问,使用 prepare().bind() 预编译语句、all/first/run 获取结果,batch() 顺序执行多语句;支持索引、PRAGMA optimize、本地数据库与远程绑定、time-travel 查看与恢复历史数据。

必要用法:npx wrangler d1 create my-database 创建库;在 wrangler.jsonc 配置 d1_databases 绑定(binding、database_name、database_id、preview_database_id);npx wrangler d1 migrations create/apply/list 管理迁移,--local 测试、--remote 上线;npx wrangler d1 execute 执行查询。代码中始终使用 env.DB.prepare(...).bind(...),不要对用户输入使用 exec(),批量操作使用 batch(),可选值传 null 而非 undefined,迁移加 IF NOT EXISTS 且不要写 BEGIN TRANSACTION,生产库 ID 不要硬编码公开。

适用场景:Workers 应用的用户、文章等 CRUD,分页与关联查询,数据迁移与本地开发测试。

限制:资料未提供具体计费、价格、区域与配额细节;D1 不支持多语句事务,batch 失败即停止;大规模 INSERT 需拆分为 100-250 行;单语句长度、内存与速率有限制;避免 SELECT * 和循环单条查询。部分新特性如远程绑定、读复制需较新 wrangler 版本,官方文档链接见 developers.cloudflare.com/d1/。