用途:本技能是 Drizzle ORM 与 Drizzle Kit 的 API 参考,供在 TypeScript 中设计数据库模式、编写查询和迁移时查阅。目标是 headless ORM,不包含运行时之外的封装。
主要能力与内容范围:
- 模式声明:pgTable / mysqlTable / sqliteTable,索引与约束、sequence、view、schema 命名空间、RLS、生成列、自定义类型与 codecs。
- 两套查询 API:SQL-like 查询构建器(select / insert / update / delete、运算符、join、alias)与 RQB 关系查询(db.query、defineRelations、with 嵌套关系获取)。
- drizzle-kit CLI:generate / migrate / push / pull / export / check / up / studio,以及 drizzle.config.ts 配置。
- 进阶:事务、batch API、缓存、动态查询构建、read replica、集合运算、性能调优。
- 校验与扩展:drizzle-zod / valibot / typebox / arktype / effect-schema 模式生成,eslint-plugin-drizzle、drizzle-graphql。
- 迁移与种子:v0.x→v1.0 破坏性变更与升级步骤,drizzle-seed 确定性假数据。
使用方式:从任务映射到分类,先读 references/{category}/README.md 定位页面,再读对应 .md。参考目录覆盖 getting-started、schema、column-types、connect、queries、relational-queries、drizzle-kit、advanced、validations、extensions、migration、seeding 等;samples 提供常见用法示例。安装使用 npm i drizzle-orm@rc 与 npm i -D drizzle-kit@rc。
限制:目标版本为 drizzle-orm / drizzle-kit 1.0.0-rc.5,npm dist-tag latest 的 0.45.2 不在范围内。SQL Server 低层连接(tedious / msnodesqlv8)参见 mssql 技能,Supabase、zod、Upstash Redis 本体 API 分别参见对应技能。其他细节资料暂未提供。