SQL 的直觉
select、join、groupBy、window——与 SQL 一一对应。懂 SQL,就懂 Drizzle,不需要学习另一套查询语言。
Drizzle 是一个「有头脑」的无头 TypeScript ORM。声明式 schema、类 SQL 的查询构建器、 零代码生成——类型安全贯穿从建表到查询的每一步。
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;import { eq, desc, sum } from 'drizzle-orm';
import { db } from './db';
import { orders, users } from './schema';
const rows = await db
.select({ name: users.name, total: sum(orders.amount) })
.from(users)
.innerJoin(orders, eq(orders.userId, users.id))
.where(eq(orders.status, 'paid'))
.groupBy(users.name, users.id)
.orderBy(desc(sum(orders.amount)))
.limit(10);CREATE TABLE "users" (
"id" serial PRIMARY KEY NOT NULL,
"name" text NOT NULL,
"email" varchar(255),
"role" text DEFAULT 'member' NOT NULL,
"created_at" timestamp DEFAULT now() NOT NULL
);
--> statement-breakpoint
CREATE UNIQUE INDEX "users_email_idx" ON "users" ("email");// 为什么选择 Drizzle
没有黑盒 DSL,也没有运行时魔法。Drizzle 把 SQL 原样交还给你,同时让类型系统覆盖每一处细节。
select、join、groupBy、window——与 SQL 一一对应。懂 SQL,就懂 Drizzle,不需要学习另一套查询语言。
从 schema 推断列类型与查询结果,IDE 自动补全贯穿始终。改动数据结构时,编译器会指出每一处受影响的位置。
schema 就是 TypeScript 代码。没有生成目录、没有守护进程、没有隐藏产物——导入即用,重构即生效。
为 PostgreSQL、MySQL、SQLite、SingleStore、Gel 提供核心适配,共享同一套查询 API 与类型体验。
drizzle-kit 负责 generate、migrate、push 与 pull,把 schema 变更变成可审查、可版本化的 SQL 文件。
Cloudflare Workers 与 D1、Neon、Turso、Bun、Deno、PGlite——没有多余依赖,任意运行时都能轻装上线。
// 可观测性
查询构建器就是 SQL 的镜像。任何时候调用 .toSQL(), 都能拿到真正发送的语句与参数——没有惊喜,没有 N+1 魔法。
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']
// }// 工作流
用 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),
});组合查询就像写 SQL,返回结果自动获得精确类型。
const rows = await db
.select({
title: posts.title,
author: users.name,
})
.from(posts)
.leftJoin(users, eq(posts.authorId, users.id))
.limit(20);drizzle-kit 对比 schema 差异,生成可审查的 SQL 迁移并执行。
$ bunx drizzle-kit generate
$ bunx drizzle-kit migrate// 方言与运行时
从传统 PostgreSQL 到边缘数据库与无服务器运行时,同一套 API、同一份类型、同一种体验。
// docs
基于 Drizzle 官方 README 与文档整理翻译,覆盖从入门、schema 设计、查询到迁移上线的完整路径。
本站为非官方中文翻译,内容以官方英文文档为准。