SuperAPI AI 工具集

d1-database

数据与分析

查看项目

更新于 10-16 02:33

技能介绍

用途:D1 是 Cloudflare 原生的无服务器 SQL 数据库,基于 SQLite,可在边缘运行查询,具备自动复制与低延迟特性。适合关系型数据、复杂查询(JOIN、聚合)、用户数据、内容管理、电商与分析等场景;简单键值数据宜用 Workers KV,大文件用 R2,实时协调用 Durable Objects,高频写入可结合 Queues。

主要能力:支持完整 SQL、JSON 函数、外键、FTS5 全文检索、数学函数与 PRAGMA;提供 prepare/bind/run、all、first、batch、raw 等 API,返回结果含 success、meta.changes、last_row_id、duration 等元数据。

使用方式:先执行 wrangler d1 create my-database 创建数据库,将 database_id 写入 wrangler.jsonc 的 d1_databases 绑定(binding、database_name、database_id、migrations_dir),再运行 wrangler types 生成 TypeScript 类型。迁移用 wrangler d1 migrations create 创建文件,先 wrangler d1 migrations apply my-database --local 本地测试,再 --remote 应用;可用 migrations list 查看待执行迁移。查询务必使用参数化 .bind() 防止 SQL 注入,并用泛型标注结果类型。批量操作使用 db.batch(),最多 100 条语句,同一数据库,整体原子执行。

限制与注意:D1 跨区域复制,读取可能略有延迟,需按最终一致性设计;批量语句不能相互读取结果;应使用 LIMIT 分页、为 WHERE/JOIN/ORDER BY 列建索引、避免 SELECT *,并检查 result.success 与唯一约束错误。资料未提供具体收费、价格与配额信息。