跳到正文
Drizzle

概览

Drizzle ORM 是「活在 TypeScript 里的 SQL」——类型优先、零代码生成的 TypeScript SQL ORM。

非官方中文文档

本站依据 Drizzle 官方 README 与文档整理翻译,与 Drizzle Team 无隶属关系。如果译文与英文原文存在出入,请以官方英文文档为准。

Drizzle ORM 是一个为 SQL 数据库设计的 TypeScript ORM。它不隐藏 SQL,也不发明另一套查询语言:schema 就是 TypeScript 代码,查询构建器就是 SQL 的镜像,结果类型由 schema 自动推导。

它看起来像 SQL,用起来像 TypeScript:

import { eq } from 'drizzle-orm';
import { db } from './db';
import { users } from './db/schema';

const admins = await db
  .select({ id: users.id, email: users.email })
  .from(users)
  .where(eq(users.role, 'admin'));
//    ^? { id: number; email: string }[]

一段代码,读懂 Drizzle

一个数据库、一份 schema、一条查询,就构成了 Drizzle 的最小闭环。

import { integer, pgTable, timestamp, varchar } from 'drizzle-orm/pg-core';

export const users = pgTable('users', {
  id: integer('id').primaryKey().generatedAlwaysAsIdentity(),
  name: varchar('name', { length: 255 }).notNull(),
  email: varchar('email', { length: 255 }).notNull().unique(),
  createdAt: timestamp('created_at').defaultNow().notNull(),
});
import { drizzle } from 'drizzle-orm/node-postgres';
import * as schema from './schema';

export const db = drizzle(process.env.DATABASE_URL!, { schema });
import { db } from './db';
import { users } from './db/schema';

const result = await db.select().from(users);

没有生成目录、没有守护进程、没有运行时元数据扫描。导入 users,类型就已经存在。

核心特性

SQL 优先的查询构建器

select、join、groupBy、having、CTE、窗口函数——Drizzle 的 API 与 SQL 概念一一对应。你不需要把查询「翻译」成 ORM 抽象,也不必为复杂查询退回裸 SQL 字符串。

类型安全贯穿始终

schema 是唯一事实来源。列的可空性、默认值、枚举、关联关系都会反映到查询参数和返回类型中。修改 schema 后,编译器会指出所有需要跟进的位置。

零代码生成

schema 直接写在 .ts 文件里,不经过 codegen 步骤。没有需要提交的生成产物,也没有需要保持同步的客户端。

无头(headless)、无绑定

Drizzle 不捆绑连接池、不托管数据库、不要求特定运行时。你可以使用任意驱动,部署到 Node.js、Bun、Deno、Cloudflare Workers、Vercel 或你自己的服务器。

可审查的迁移

drizzle-kit 对比 schema 差异并生成普通 SQL 文件。迁移在合并前可以被逐行审查、在 CI 中校验、在部署时按顺序执行。

极小的运行时足迹

drizzle-orm 没有沉重的运行时依赖,在无服务器和边缘环境中冷启动开销小,适合对包体积敏感的应用。

支持的数据库

数据库常用驱动与适配器迁移方言
PostgreSQLnode-postgres、postgres.js、Neon、Supabase、Xata、PGlite、AWS Data APIpostgresql
MySQLmysql2、PlanetScale、TiDB Serverlessmysql
SQLitebetter-sqlite3、Bun SQLite、Cloudflare D1、libSQL / Turso、Expo SQLite、Op-SQLitesqlite
其他SingleStore、Gelsinglestore、gel

完整驱动列表与连接方式见连接数据库和生态系统。

文档导览

版本说明

关于 v1 Beta / RC

Drizzle ORM v1 处于 Beta / RC 阶段,关系查询(defineRelations)、内置校验(drizzle-orm/zod)等新 API 仍在演进。本站已覆盖这些新 API,并在涉及版本差异处单独标注;生产项目请锁定版本,并以官方迁移指南为准。

下一步