用途:为 Drizzle ORM 提供类型安全的数据库应用开发指导,涵盖模式定义、表间关系、CRUD 查询、复杂连接与聚合、事务回滚以及 Drizzle Kit 迁移配置。
主要能力:按数据库方言选用表函数(PostgreSQL 用 pgTable,MySQL 用 mysqlTable,SQLite 用 sqliteTable,MSSQL 用 mssqlTable,另有 CockroachDB);用 db.insert()、db.select()、db.update()、db.delete() 执行 CRUD;用 db.transaction() 包裹多步操作并支持 tx.rollback();用 relations() 或 defineRelations() 定义一对一、一对多、多对多关系;使用 Drizzle Kit 做迁移。
必要用法:先确定数据库方言,再用对应表函数定义 schema 并建立 relations,然后初始化 Drizzle 客户端,最后编写类型安全查询。示例:import { pgTable, serial, text } from 'drizzle-orm/pg-core'; const db = drizzle(process.env.DATABASE_URL); const [user] = await db.select().from(users).where(eq(users.id, 1));
最佳实践:始终用 TypeScript 与 $inferInsert / $inferSelect;外键引用用箭头函数 () => table.column 避免循环依赖;生产环境用 generate + migrate,开发用 push;常查询列与外键加索引;用 deletedAt 做软删除;大数据集用游标分页;用 .limit() 与 .where() 优化查询。
限制与警告:tx.rollback() 会抛异常,需要时用 try/catch;并非所有数据库都支持 .returning(),需检查方言兼容性;大批量插入可能触及数据库限制,应分块;生产迁移须先在预发布环境测试。