Drizzle ORM 中 inet 类型导致 Drizzle Studio 查询运行器失效问题解析

在使用 Drizzle ORM 进行 PostgreSQL 数据库开发时，开发者可能会遇到一个特定问题：当数据库表中包含 inet 类型字段时，Drizzle Studio 的查询运行器功能将无法正常工作。

问题现象

在 Drizzle ORM 0.30.4 和 Drizzle Kit 0.20.17 版本中，如果数据库表结构定义如下：

export const leads = pgTable("leads", {
  id: uuid("id").primaryKey().defaultRandom(),
  ip: inet("ip"),
  createdAt: timestamp("created_at", { withTimezone: true })
    .notNull()
    .defaultNow(),
});

当尝试在 Drizzle Studio 中使用"查询运行器"功能时，系统会抛出"ReferenceError: inet is not defined"错误。值得注意的是，这个问题仅影响查询运行器功能，SQL 运行器功能仍可正常使用。

技术背景

inet 是 PostgreSQL 特有的数据类型，用于存储 IPv4 或 IPv6 地址。在 Drizzle ORM 中，inet 是作为 PostgreSQL 特定类型提供的列类型之一。然而，在 Drizzle Studio 的查询运行器环境中，似乎没有正确导入或识别这一类型。

解决方案

根据 Drizzle 团队成员的回复，该问题已被修复。开发者可以采取以下步骤：

1. 确保使用的是最新版本的 Drizzle ORM 和 Drizzle Kit
2. 重新尝试在 Drizzle Studio 中使用查询运行器功能

最佳实践

为避免类似问题，建议开发者在定义 PostgreSQL 特定类型时：

1. 始终从正确的模块导入类型（如从 drizzle-orm/pg-core 导入）
2. 定期更新 Drizzle 相关工具链
3. 对于关键功能，考虑在开发环境中进行充分测试

总结

数据库 ORM 工具在处理特定数据库类型时可能会遇到环境兼容性问题。Drizzle ORM 团队对此类问题的快速响应体现了项目的活跃维护状态。开发者在使用特定数据库类型时，应关注相关工具的更新日志，并及时应用修复补丁。