Cloudflare D1 的 ORM 选择：Prisma 还是 Drizzle

前言

Cloudflare 提供了非常廉价的数据库服务 D1，在免费额度下，用户可以获得 5GB 的存储空间，每天支持 500 万行的读取和 10 万行的写入

因为同时使用了 Cloudflare 提供的大量其他免费服务，就想要一起使用 D1 作为服务的后端存储

虽然 D1 也提供了接口，可以执行 SQL 语句进行增删改查，但使用 ORM 框架更为方便高效。因此，这里选择了两个较为流行的 ORM 框架，Prisma 和 Drizzle，分别简单介绍它们在 Cloudflare 上的使用，并且进行对比

Cloudflare D1 的小坑

尽管 Cloudflare D1 提供了大量免费额度，但在实际使用中，瓶颈并不在这里，而是在另一个方面

Cloudflare D1 的调用，并不像别的 Serverless 数据库服务，会给出一个连接串，Cloudflare D1 的所有调用都必须通过 Cloudflare Workers 在内网进行

而对于 Workers，在免费计划下，CPU 时间的最大值为 10ms

所以哪怕你只是稍微轻度地使用一下 Cloudflare D1，一共就只有几万行数据，每天就查几次，也大概会碰到这个瓶颈

如果你基于 Cloudflare 构建自己的有状态服务（需要数据库），很难不订阅月付 $5 的 Workers Paid，订阅后，每次 Workers 调用的最大时长被放宽到 30s

那么其他的 Serverless 平台呢？比如 Vercel

对于真正的小用量用户来说，Vercel 的数据库表现更好，至少在轻量使用情况下没有问题

如果用量稍微上来一点，比如一共有几十万行，每天会读几百万行，那 Vercel 的免费计划就撑不住了，但 Vercel 的最低付费计划需要每月 $25，远远超过 Cloudflare 的每月 $5

因此，对于一个简单的服务来说，Cloudflare Workers Paid 的性价比远高于 Vercel Pro Plan，且价格更便宜，每月 $5 是一个非常有性价比的价格。

Prisma

网络问题

Cloudflare 官方的这篇文档很好，已经基本覆盖了所有内容，能够上手了，下面补充一些文档里没有提到的细节

大部分身处中国大陆的用户可能会遇到一些网络问题，这些问题比普通的依赖下载更为复杂

根据 Prisma 的架构，会有一个引擎来翻译被调用的高级 API

而这个引擎是一个二进制文件，下载起来就比代码构成的其他依赖就更加麻烦

如果遇到了其他网络问题，设置了代理等方法还不行，同时在使用 pnpm install 和 pnpm dlx，可以换回 npm install 和 npx 试试

基本使用

首先，数据库连接和表的定义都会放在 prisma/schema.prisma 下面

然后根据需要，进行数据库迁移，比如，你在本地声明式地添加了一张新表（schema.prisma 中的一个新 model），就需要对远程的数据库应用这一次迁移

对于 Cloudflare D1 来说，数据库迁移没有那么容易，可能是因为 Prisma 才支持 D1 不久，所以步骤比较繁琐，详情见文档

然后用 npx prisma generate 生成 Prisma Client，生成的 Prisma Client 包含了类型定义，在写 Typescript 代码的时候就可以用到这些定义

在具体的使用中，对于 SQL 中的增删改查，Prisma 也有相应的函数，只是会稍微有一点不一样，可以参考文档

Drizzle

和 Prisma 不同，使用 Drizzle 的负担小很多，没有二进制文件的依赖，Drizzle 仅仅是在原生 SQL 上添加了一层薄薄的抽象

首先需要一个 db/schema.ts 文件来定义表，比如：

// db/schema.ts
import { sqliteTable, text, integer } from 'drizzle-orm/sqlite-core';

export const countries = sqliteTable('countries', {
    id: integer('id').primaryKey(),
    name: text('name'),
}
);

▶

接下来，可以用 Drizzle 的数据库迁移功能，也可以自己写 sql 文件管理数据库结构，展开具体步骤

然后在项目根目录中新建文件 drizzle.config.ts，配置数据库迁移的规则：

注意，这里所说的数据库迁移，不是把数据从一个数据库搬到另一个数据库

在 ORM 的语境下，数据库迁移是指在同一个数据库中，改变表的结构，可以参考一下 Prisma 的文档理解一下这个概念

// drizzle.config.ts
import type { Config } from "drizzle-kit";

export default {
    schema: "./db/schema.ts",
    out: "./db/migrations",
    dialect: "sqlite",
    dbCredentials: {
        wranglerConfigPath: "wrangler.toml",
        dbName: "<your-db-name>",
    },
} satisfies Config;

然后用 npx drizzle-kit generate 生成迁移文件，注意产生的迁移文件需要跟着 Git 走，不然下次迁移就不好用了

在 wrangler.toml 中添加 migrations_dir = "db/migrations"

然后用 npx wrangler d1 migrations apply <your-db-name> --remote 应用迁移文件

然后直接在代码里使用这些定义，比如：

import { drizzle } from 'drizzle-orm/d1';
import { countries } from './schema';

export interface Env {
	db: D1Database;
}

export default {
	async fetch(request: Request, env: Env) {
		const db = drizzle(env.db);
		const result = await db.select().from(countries).where(eq(countries.id, 5));
		return Response.json(result);
	},
};