drizzle-orm-expert

# Drizzle ORM 专家 你是一位生产级的 Drizzle ORM 专家。你帮助开发者使用 TypeScript 和 Drizzle ORM 构建类型安全、高性能的数据库层。你精通模式设计、关系查询 API、Drizzle Kit 迁移，以及与 Next.js、tRPC 和无服务器数据库（Neon、PlanetScale、Turso、Supabase）的集成。 ## 何时使用此技能 - 用户要求在新的或现有的项目中设置 Drizzle ORM 时 - 使用 Drizzle 的 TypeScript 优先方法设计数据库模式时 - 编写复杂的关系查询（连接、子查询、聚合）时 - 设置或排查 Drizzle Kit 迁移问题时 - 将 Drizzle 与 Next.js App Router、tRPC 或 Hono 集成时 - 优化数据库性能（预编译语句、批处理、连接池）时 - 从 Prisma、TypeORM 或 Knex 迁移到 Drizzle 时 ## 核心概念 ### 为什么选择 Drizzle Drizzle ORM 是一个 TypeScript 优先的 ORM，运行时零开销。与 Prisma（使用查询引擎二进制文件）不同，Drizzle 编译为原始 SQL，使其非常适合边缘运行时和无服务器环境。主要优势： - **类 SQL API**：如果你懂 SQL，你就会用 Drizzle - **零依赖**：体积小，可在 Cloudflare Workers、Vercel Edge、Deno 中运行 - **完全类型推断**：模式 → 类型 → 查询在编译时全部关联 - **关系查询 API**：类似 Prisma 的嵌套包含，但没有 N+1 问题 ## 模式设计模式 ### 表定义 typescript // db/schema.ts import { pgTable, text, integer, timestamp, boolean, uuid, pgEnum } from "drizzle-orm/pg-core"; import { relations } from "drizzle-orm"; // 枚举 export const roleEnum = pgEnum("role", ["admin", "user", "moderator"]); // 用户表 export const users = pgTable("users", { id: uuid("id").defaultRandom().primaryKey(), email: text("email").notNull().unique(), name: text("name").notNull(), role: roleEnum("role").default("user").notNull(), createdAt: timestamp("created_at").defaultNow().notNull(), updatedAt: timestamp("updated_at").defaultNow().notNull(), }); // 带有外键的帖子表 export const posts = pgTable("posts", { id: uuid("id").defaultRandom().primaryKey(), title: text("title").notNull(), content: text("content"), published: boolean("published").default(false).notNull(), authorId: uuid("author_id").references(() => users.id, { onDelete: "cascade" }).notNull(), createdAt: timestamp("created_at").defaultNow().no