Skip to content

概念

每个 D1 database 对应本机一份 SQLite。所有查询都发往该数据库。不提供 replica 集合,因此也没有读从库 / 写主库分流。

session 与不透明 bookmark 仍然存在。bookmark 保证同一数据库上的本地顺序可见性,不是跨区域因果。rows_read / rows_written 是本次 SQLite 执行的稳定计数,不是 Cloudflare 计费计数。

dump() 对当前 hosted 非 alpha 模型拒绝(D1_DUMP_ERROR),与托管行为一致。

preparebindrun / all / first / rawbatch 顺序、原子。exec 执行无参数 SQL。withSession 接受 "first-primary" / "first-unconstrained" / bookmark 字符串。见 D1 Worker API

兼容性

主题Cloudflareopen-compute
Worker APID1 Worker API相同:prepare / bind / run / all / first / raw / exec / batch、session、bookmark
Read replica / region routing提供不提供
Bookmark跨副本因果同一数据库的本地顺序
rows_read / rows_written计费计数本地 SQLite 执行计数
dump()hosted 非 alpha 拒绝同样拒绝

下一步:指南