SuperAPI AI 工具集

drizzle

编程与开发

查看项目

更新于 10-16 01:15

技能介绍

用途:Drizzle ORM 是轻量、TypeScript 优先的 ORM,提供类 SQL 查询构建器、schema-as-code 迁移和零依赖特性,用于在 TypeScript 项目中以类型安全方式访问 SQL 数据库。

主要能力:内置 schema 校验适配器,通过 drizzle-zod、drizzle-valibot 等与 Zod、Valibot、TypeBox、ArkType、Effect Schema 集成,可直接从 Drizzle schema 推断 insert/select 类型,无需手写镜像校验 schema;内置 drizzle-seed 种子数据能力,支持可复现的 PRNG、加权分布和跨方言。

用法与最佳实践:编写代码前应先通过 WebFetch 读取实时文档 https://orm.drizzle.team/llms.txt ,不要假设 API 或配置存在。需要跨函数组合查询时调用 .$dynamic() 以解锁多次调用模式,并用方言泛型(PgSelect、MySqlSelect、SQLiteSelect)作为参数类型。db.query.* 关系查询只生成一条 SQL,嵌套 offset 不支持,嵌套关系分页需改用 where 加游标逻辑。drizzle-kit push 只用于开发,生产应使用 drizzle-kit generate + drizzle-kit migrate。服务端无服务器环境不要按请求实例化 drizzle(),应导出模块级单例复用。drizzle-kit pull 与 push 不保留迁移文件中手写 SQL,自定义迁移应单独编号管理。db.query.* 关系查询需要显式定义 relations(),不会像 Prisma 那样自动从外键推断,缺失时运行时报错。

限制:资料未提供收费、价格、平台兼容范围和具体版本支持等细节。