跳到正文
Drizzle

其他校验集成

valibot、TypeBox、ArkType、Effect Schema 与 Drizzle 的集成:包名、createSchema 函数与 insert 校验示例。

除 Zod 外,Drizzle 官方还为 valibot、TypeBox、ArkType 与 Effect Schema 提供集成。模式完全一致:createInsertSchema / createSelectSchema / createUpdateSchema 把表定义转换成对应库的 schema,refine 规则也相同——传回调是扩展,直接传 schema 是覆盖。

包名与入口对照

官方最新文档中,这些集成已内置为 drizzle-orm 的子路径(随 v1 提供,当前安装 drizzle-orm@rc);v0.x 项目使用对应的独立包,函数名相同。

库v1 内置子路径v0 独立包校验入口
valibotdrizzle-orm/valibotdrizzle-valibotparse(schema, data)
TypeBoxdrizzle-orm/typebox(配 typebox 包)drizzle-typebox(配 @sinclair/typebox)Value.Check / Value.Parse
ArkTypedrizzle-orm/arktypedrizzle-arktype直接调用 schema(data),失败返回 ArkErrors
Effect Schemadrizzle-orm/effect-schema—Schema.decodeUnknownEffect

四个集成都支持表、视图与枚举的 select schema,以及表的 insert/update schema。

bun add drizzle-orm@rc valibot
import { pgTable, text, integer } from 'drizzle-orm/pg-core';
import { createInsertSchema } from 'drizzle-orm/valibot';
import { parse, pipe, maxLength } from 'valibot';

const users = pgTable('users', {
  id: integer().generatedAlwaysAsIdentity().primaryKey(),
  name: text().notNull(),
  age: integer().notNull(),
});

const userInsertSchema = createInsertSchema(users, {
  name: (schema) => pipe(schema, maxLength(20)), // 扩展默认规则
});

const parsed = parse(userInsertSchema, { name: 'Jane', age: 30 });
await db.insert(users).values(parsed);

refine 规则速记

第二个参数是一个「列名 → 规则」的对象,四个库语义一致:

  • (schema) => ...:在默认生成的 schema 上扩展,发生在列变为 nullable/optional 之前。
  • 直接给一个该库的 schema:覆盖整列规则,包括可空性。

例如 valibot 中 preferences: object({ theme: string() }) 会完全替换 json 列的默认宽松校验。

TypeBox 新旧版本

TypeBox 生态有两个包名:新版 typebox 与旧版 @sinclair/typebox。官方对应提供两个子路径:

子路径搭配的包说明
drizzle-orm/typeboxtypebox当前推荐
drizzle-orm/typebox-legacy@sinclair/typebox旧项目兼容,Value.Parse 等用法一致

v0.x 的 drizzle-typebox 独立包搭配 @sinclair/typebox 使用。

如何选择

已有技术栈优先:用 valibot 追求 bundle 体积、用 Effect 做函数式错误处理、用 ArkType 喜欢类型即校验的写法。没有历史包袱时,Zod 生态最成熟,见 Zod 校验。

下一步