跳到正文
Drizzle

生态系统

Drizzle 的驱动矩阵、drizzle-kit、Drizzle Studio、drizzle-seed 与 schema 校验工具。

Drizzle 的核心很小,周围围绕着一组官方工具与社区集成。理解它们各自的职责,可以避免把「迁移工具」「校验库」「GUI」误当成 ORM 的一部分。

官方工具

工具职责
drizzle-orm查询构建器、schema 定义、类型推导
drizzle-kit迁移生成与执行、push/pull、Studio 启动
Drizzle Studio本地数据库浏览与编辑界面
drizzle-seed可复现的种子数据生成
drizzle-zod从 schema 生成 Zod 校验器
drizzle-valibot从 schema 生成 Valibot 校验器
drizzle-arktype从 schema 生成 ArkType 校验器

drizzle-seed

drizzle-seed 可以根据 schema 生成结构合法的测试数据,并通过固定种子保证可复现:

bun add -d drizzle-seed
import { seed } from 'drizzle-seed';
import { db } from './db';
import * as schema from './db/schema';

await seed(db, schema).refine((f) => ({
  users: {
    count: 50,
    columns: {
      name: f.fullName(),
      email: f.email(),
    },
  },
  posts: {
    count: 200,
  },
}));

具体生成器与 refine 语法会随版本变化,请以官方文档为准。

schema 校验

以 drizzle-zod 为例,同一份 schema 可以同时服务于数据库与 API 输入校验:

import { createInsertSchema, createSelectSchema } from 'drizzle-zod';
import { users } from './db/schema';

export const insertUserSchema = createInsertSchema(users, {
  email: (schema) => schema.email(),
});

export const selectUserSchema = createSelectSchema(users);

这样可以避免「数据库 schema」与「请求校验 schema」各写一份而逐渐漂移。

驱动矩阵

PostgreSQL

驱动导入路径适用场景
node-postgresdrizzle-orm/node-postgresNode.js 服务、脚本
postgres.jsdrizzle-orm/postgres-jsNode.js、Bun、Deno
Neon HTTPdrizzle-orm/neon-http边缘与无服务器
Neon WebSocketdrizzle-orm/neon需要交互式事务
Vercel Postgresdrizzle-orm/vercel-postgresVercel 平台
PGlitedrizzle-orm/pglite浏览器、测试、嵌入式
AWS Data APIdrizzle-orm/aws-data-api/pgAWS Lambda + RDS
Xatadrizzle-orm/xata-httpXata 平台

MySQL

驱动导入路径适用场景
mysql2drizzle-orm/mysql2Node.js 服务
PlanetScaledrizzle-orm/planetscale-serverlessPlanetScale 无服务器
TiDB Serverlessdrizzle-orm/tidb-serverlessTiDB Cloud

SQLite

驱动导入路径适用场景
Bun SQLitedrizzle-orm/bun-sqliteBun 运行时
better-sqlite3drizzle-orm/better-sqlite3Node.js 同步驱动
Cloudflare D1drizzle-orm/d1Workers + D1
libSQL / Tursodrizzle-orm/libsql远程 SQLite、边缘复制
Expo SQLitedrizzle-orm/expo-sqliteReact Native / Expo
Op-SQLitedrizzle-orm/op-sqliteReact Native 高性能驱动

其他数据库

  • SingleStore:drizzle-orm/singlestore
  • Gel:drizzle-orm/gel

以官方文档为准

驱动列表会随版本更新。新增适配器与具体连接参数请查阅官方文档的「Connect」章节,或直接查看对应包的类型定义。

与框架和平台集成

Drizzle 不绑定框架,因此集成方式通常是「在框架的数据库初始化位置接入驱动」:

  • Astro:在 src/db 中初始化,按需在端点或服务端组件中调用。
  • Next.js:在服务端模块或 Route Handler 中复用连接池。
  • Hono / Cloudflare Workers:从 env 获取 D1 绑定,按请求创建轻量客户端。
  • Bun / Deno:直接使用内置 SQLite 或 postgres.js。
  • Better Auth 等认证库:许多社区库提供 Drizzle 适配器,可直接复用同一份 schema。

学习资源

下一步

深入参考