SuperAPI AI 工具集

drizzle

编程与开发

查看项目

更新于 10-27 13:02

技能介绍

Drizzle 是一个面向 TypeScript 的现代 ORM,强调零依赖、编译期类型安全以及类似 SQL 的语法,并针对边缘运行时和无服务器环境进行了优化。

一、用途 Drizzle 用于在 TypeScript 项目中以类型安全的方式定义数据库 schema、执行增删改查、建立表关系、运行事务以及管理数据库迁移。它适合需要贴近 SQL 控制力、同时希望获得完整类型推断的开发者。

二、主要能力

  1. 类型安全:通过 schema 定义自动推断查询结果的 TypeScript 类型,例如使用 typeof users.$inferSelect 和 typeof users.$inferInsert。
  2. 多数据库支持:提供 PostgreSQL、MySQL、SQLite 的列类型与驱动适配,如 pg、mysql2、better-sqlite3。
  3. 查询能力:支持插入、查询、更新、删除,以及 eq、ne、gt、gte、lt、lte、like、ilike、inArray、isNull、isNotNull、and、or、between 等过滤操作符,支持 innerJoin、leftJoin、聚合、分组、排序、分页。
  4. 关系定义:通过 relations 支持一对多、多对多关系,并可用 db.query 的 with 选项进行关联查询。
  5. 事务:支持 db.transaction 自动回滚,也支持手动 rollback。
  6. 迁移工具 Drizzle Kit:支持 generate 生成迁移、migrate 应用迁移、introspect 内省现有数据库、studio 启动数据库 GUI。

三、使用方式 安装核心包与数据库驱动:

Core ORM

npm install drizzle-orm

Database driver (choose one)

npm install pg # PostgreSQL npm install mysql2 # MySQL npm install better-sqlite3 # SQLite

Drizzle Kit (migrations)

npm install -D drizzle-kit

在 schema 文件中使用 pgTable 等定义表结构,在 client 文件中通过 drizzle 连接数据库并传入 schema。随后即可使用 db.insert、db.select、db.update、db.delete 等 API 操作数据。迁移通过 drizzle.config.ts 配置 schema、out、dialect 和 dbCredentials,再运行 npx drizzle-kit generate、npx drizzle-kit migrate 等命令。

四、适用场景 适合 TypeScript 项目、边缘运行时与无服务器环境、需要类型安全查询和贴近 SQL 语法的场景,以及需要迁移管理和数据库内省的开发流程。资料还提到可与 typescript-core、nextjs-core 等技能配合使用。

五、限制与注意事项 资料中的 Red Flags 指出:JSON 列不应在无类型标注时使用 any 或 unknown;不应在未使用 sql 模板的情况下拼接原始 SQL 字符串(存在 SQL 注入风险);多步数据修改应使用事务;生产查询不应无分页地获取全部行;外键或高频查询列应建立索引;大表使用 select() 时应指定列。

六、性能对比 资料给出与 Prisma 的对比数据:包体积约 35KB 对约 230KB;冷启动约 10ms 对约 250ms;查询速度以 Drizzle 为基线,Prisma 约慢 2-3 倍;内存约 10MB 对约 50MB;类型生成方式为运行时推断对构建时生成。

关于收费、价格、平台支持范围等更多信息,资料暂未提供。