v1 Beta · Apache-2.0 · 开源

活在 TypeScript
里的 SQL

Drizzle 是一个「有头脑」的无头 TypeScript ORM。声明式 schema、类 SQL 的查询构建器、 零代码生成——类型安全贯穿从建表到查询的每一步。

$bun add drizzle-ormbun add drizzle-orm
支持 npm · pnpm · yarn · bun
import {
  pgTable, serial, text, timestamp, varchar,
} from 'drizzle-orm/pg-core';

export const users = pgTable('users', {
  id: serial('id').primaryKey(),
  name: text('name').notNull(),
  email: varchar('email', { length: 255 }).unique(),
  role: text('role').default('member').notNull(),
  createdAt: timestamp('created_at').defaultNow().notNull(),
});

export type User = typeof users.$inferSelect;
drizzle-orm · type-safeUTF-8 · LF
GitHub Stars
36.3k
代码生成
0
数据库驱动
15+
开源协议
Apache-2.0

// 为什么选择 Drizzle

SQL 的掌控感,TypeScript 的安全感。

没有黑盒 DSL,也没有运行时魔法。Drizzle 把 SQL 原样交还给你,同时让类型系统覆盖每一处细节。

01

SQL 的直觉

select、join、groupBy、window——与 SQL 一一对应。懂 SQL,就懂 Drizzle,不需要学习另一套查询语言。

02

端到端类型安全

从 schema 推断列类型与查询结果,IDE 自动补全贯穿始终。改动数据结构时,编译器会指出每一处受影响的位置。

03

零代码生成

schema 就是 TypeScript 代码。没有生成目录、没有守护进程、没有隐藏产物——导入即用,重构即生效。

04

一份 schema,多种方言

为 PostgreSQL、MySQL、SQLite、SingleStore、Gel 提供核心适配,共享同一套查询 API 与类型体验。

05

迁移全流程

drizzle-kit 负责 generate、migrate、push 与 pull,把 schema 变更变成可审查、可版本化的 SQL 文件。

06

边缘就绪

Cloudflare Workers 与 D1、Neon、Turso、Bun、Deno、PGlite——没有多余依赖,任意运行时都能轻装上线。

// 可观测性

没有魔法,
只有看得见的 SQL。

查询构建器就是 SQL 的镜像。任何时候调用 .toSQL(), 都能拿到真正发送的语句与参数——没有惊喜,没有 N+1 魔法。

  • 参数化查询,默认远离 SQL 注入
  • 生成的 SQL 可读、可审查、可直接 EXPLAIN
  • 支持 CTE、窗口函数、子查询与 JSON 聚合
了解查询构建器
to-sql.ts
import { eq } from 'drizzle-orm';
import { db } from './db';
import { users } from './schema';

const statement = db
  .select({ id: users.id, name: users.name })
  .from(users)
  .where(eq(users.role, 'admin'))
  .toSQL();

// {
//   sql: 'select "id", "name" from "users" where "role" = $1',
//   params: ['admin']
// }
prepared statement · 1 组参数

// 工作流

三步进入生产。

阅读迁移指南
01 / Schemats

用 TypeScript 描述数据表,编辑器就是你的 schema 设计器。

export const posts = pgTable('posts', {
  id: serial('id').primaryKey(),
  title: text('title').notNull(),
  body: text('body'),
  authorId: integer('author_id')
    .references(() => users.id),
});
02 / Queryts

组合查询就像写 SQL,返回结果自动获得精确类型。

const rows = await db
  .select({
    title: posts.title,
    author: users.name,
  })
  .from(posts)
  .leftJoin(users, eq(posts.authorId, users.id))
  .limit(20);
03 / Migrateshell

drizzle-kit 对比 schema 差异,生成可审查的 SQL 迁移并执行。

$ bunx drizzle-kit generate
$ bunx drizzle-kit migrate
✓ drizzle/0001_init.sql✓ applied

// 方言与运行时

一个 ORM,连接整个生态。

从传统 PostgreSQL 到边缘数据库与无服务器运行时,同一套 API、同一份类型、同一种体验。

  • PostgreSQL
  • MySQL
  • SQLite
  • Neon
  • Supabase
  • PlanetScale
  • Cloudflare D1
  • Turso
  • Bun SQLite
  • PGlite
  • AWS Data API
  • Gel
  • SingleStore
  • Expo SQLite
  • Xata
  • Vercel Postgres

// docs

从第一篇文档开始。

基于 Drizzle 官方 README 与文档整理翻译,覆盖从入门、schema 设计、查询到迁移上线的完整路径。

本站为非官方中文翻译,内容以官方英文文档为准。

// get started

现在,写第一条
类型安全的查询。

十分钟完成安装、建表与首次查询。无需代码生成,也不绑定任何托管服务。

Apache-2.0 · 社区驱动 · 永久免费