Drizzle ORM 中复合唯一约束的正确声明方式

Drizzle ORM 是一个现代化的 TypeScript ORM 工具，它提供了简洁而强大的 API 来操作数据库。在使用过程中，开发者可能会遇到一些 API 变更带来的困惑，特别是在声明复合唯一约束时。

问题背景

在 Drizzle ORM 的早期版本中，开发者可以通过以下方式声明复合唯一约束：

export const composite = pgTable('composite_example', {
  id: integer('id'),
  name: text('name'),
}, (t) => ({
  unq: unique().on(t.id, t.name),
  unq2: unique('custom_name').on(t.id, t.name)
}));

然而，随着 Drizzle ORM 的版本升级（当前最新版本为 0.37.0），这种声明方式已被标记为"已弃用"。当开发者继续使用这种方式时，TypeScript 编译器会给出警告提示。

新的推荐方式

Drizzle ORM 现在推荐使用数组语法来声明约束：

export const composite = pgTable(
  "composite_example",
  {
    id: integer("id"),
    name: text("name"),
  },
  (t) => [unique().on(t.id, t.name), unique("custom_name").on(t.id, t.name)],
);

这种新的语法更加简洁，也更符合 TypeScript 的类型推断机制。它通过返回一个约束数组而不是对象，使得 API 更加一致和可预测。

为什么需要变更

这种 API 变更可能有几个原因：

1. 类型安全性：数组语法可能提供了更好的类型推断和检查
2. 一致性：与其他 Drizzle ORM API 保持一致的风格
3. 性能：可能减少了运行时的对象创建开销
4. 可扩展性：为未来可能添加的其他约束类型做准备

实际应用建议

对于正在从旧版本迁移的项目，开发者应该：

1. 检查所有使用 pgTable 声明的地方
2. 将对象语法转换为数组语法
3. 确保所有约束仍然按预期工作
4. 运行测试验证数据库操作的正确性

对于新项目，直接使用新的数组语法可以避免未来可能的兼容性问题。

总结

Drizzle ORM 作为一个活跃开发的项目，API 的变更是为了提供更好的开发者体验和更强大的功能。理解并适应这些变更可以帮助开发者更高效地使用这个工具。复合唯一约束的声明方式从对象语法变为数组语法，虽然是一个小的变化，但反映了项目向更一致、更类型安全的 API 设计方向发展的趋势。