这是什么
D1 是 Cloudflare 的边缘数据库,本质是跑在 Cloudflare 网络上的 SQLite,给 Workers 应用存结构化数据。免费档跟 Workers 免费档绑定:每天读 500 万行、写 10 万行,总存储 5 GB,最多建 10 个库。个人小应用、表单收集、轻量 API 的数据层,用它不用另买数据库。
本站已实领在用。它的计量方式和直觉不一样,先说清:读写按「行」算,不按查询次数算——一条不带条件的查询扫了全表 5000 行,就记 5000 行读。用之前把这一条想明白,能省掉后面所有的坑。
怎么申请
- 用 Cloudflare 账号登录。 邮箱注册即可,不绑卡。正常几分钟。
- 创建 D1 数据库。 两条路:控制台里点几下就能建,或者本地装 Wrangler 用
wrangler d1 create命令建。准备:想好库名。正常几分钟。卡住最常见的原因是 Wrangler 没登录授权,先wrangler login再建库。 - 建表并绑定到 Worker。 用 Wrangler 或控制台执行建表 SQL,再在 Worker 的配置(wrangler.toml)里把这个库绑定上,代码里通过绑定名访问。第一次建议先建一张小表、跑通一次插入和查询,确认整条链路通,再上正式表结构。这一步正常十几分钟,卡住多半是绑定名写错或迁移没执行,对照控制台里库的绑定设置查。
- 在用量页确认计数。 跑几条查询后回控制台看读/写行数在不在动,心里建立「一次请求大概烧多少行」的概念,后面优化全靠这个数。
拿到后怎么用
- 读行数按「扫描行数」算,不是返回行数。 官方定义:一张 5000 行的表全表扫描记 5000 行读,哪怕最后只返回 3 行。过滤字段建好索引,扫描范围立刻降下来——这是 D1 省额度最有效的一招,没有之一。
- 写行数按实际写入行数算,索引会加行。 插入一行记一行写;如果被写的列上有索引,还要多记一行索引写。批量导入前先估一遍:每天写额度只有 10 万行,一次导 20 万行数据当天就爆了,分两天导或先想清楚要不要这么多数据。
- 5 GB 是所有库的总存储,库最多 10 个。 别一个小功能建一个库,10 个名额和 5 GB 都是全账号共享的。
- 超限当天该类操作失败,次日恢复。 免费档读/写任一项超了,当天对应的操作报错,等次日 00:00 UTC(北京时间 08:00)重置。给读多写少的应用留好余量,别按平均值卡着上限设计。
- 备份靠自己导出。 用 Wrangler 能把库导出成 SQL 文件,重要数据定期导一份到本地或 R2,别指望免费档有托管备份。
额度
- 读:每天 500 万行(按扫描行数计)。
- 写:每天 10 万行。
- 存储:总计 5 GB(所有库合计)。
- 数据库个数:最多 10 个。
限制
- 读写按「行」计而不是按查询次数:一条扫全表的查询能吃掉大量读行数,查询要带索引和条件。
- 5 GB 是所有库的总存储,不是每个库 5 GB。
- 免费档跟 Workers 免费档挂钩,任一项超限当天该类操作失败,次日重置。
容易卡住的地方
- 读行数掉得飞快:十有八九是没索引的全表扫描在烧。给常用过滤字段建索引,再回用量页对比扫描行数,前后能差几百倍。
- 导入数据时写额度爆了:批量插入按行记写额度,一天 10 万行封顶。大批量导入分天进行,或者导入前精简数据,别把测试数据一股脑全塞进来。
- Worker 里连不上库:先查绑定——wrangler.toml 里的绑定名和代码里用的名字要一字不差,再确认建表 SQL 真的执行过(控制台里能直接看表在不在)。
- 查询结果对不上预期:D1 是 SQLite 方言,从 MySQL/PostgreSQL 搬过来的 SQL 有些写法不通用,先拿一句简单查询验证再搬整套。
避坑
- 别拿它当分析库跑全表扫描,读行数是按行烧的,账单(额度)会教你做人。
- 重要数据定期导出备份,免费档没有托管备份的承诺。
- 它是给 Workers 配套的小数据层,需要独立数据库、复杂查询、大数据量的活,去看 Neon、Supabase 这类正经数据库的免费档。
以上信息以官方页面为准,申请前请打开官网再核对一次。
常见问题
Cloudflare D1 免费档每天能读写多少?
读 500 万行、写 10 万行,总存储 5 GB,最多 10 个库,每天 00:00 UTC(北京时间 08:00)重置。
D1 的额度是按查询次数算吗?
不是,按行算:读按扫描过的行数记(全表扫描 5000 行就记 5000),写按实际写入行数记。给过滤字段建索引能大幅减少扫描行数。
D1 要绑卡吗?
不要,Cloudflare 账号即可。
D1 超过免费额度会怎样?
当天超限的那类操作(读或写)会失败报错,不自动扣费,次日重置后恢复。设计时留余量,别卡着上限跑。
D1 能当主数据库用吗?
小应用可以:表单、配置、轻量业务数据都没问题。它是 SQLite 内核、单库 5 GB 总盘子,大数据量、复杂分析查询、强一致事务的场景不适合,去用专门的数据库免费档。
D1 的数据怎么备份?
用 Wrangler 导出 SQL 文件,自己存到本地或对象存储。定期导一份,别等出事了才想起来。