首页
/ Drizzle ORM 中 JSON 列类型的正确使用方法

Drizzle ORM 中 JSON 列类型的正确使用方法

2025-05-06 19:05:28作者:苗圣禹Peter

在使用 Drizzle ORM 进行 PostgreSQL 数据库操作时,JSON 类型字段的处理是一个常见需求。本文将详细介绍如何正确使用 JSON 列类型,避免常见的类型错误和序列化问题。

JSON 列的类型定义

在 Drizzle ORM 中,默认情况下 JSON 列的类型会被推断为 unknown | null。这是因为 JSON 数据可以包含多种形式的值:字符串、数字、布尔值、数组、对象或 null。为了确保类型安全,Drizzle 采用了最保守的类型推断策略。

import { pgTable, json, text } from "drizzle-orm/pg-core";

export const testTable = pgTable("testTable", {
  id: text("id").primaryKey().notNull(),
  testobject: json('testobject').array()
});

如何指定 JSON 列的具体类型

为了获得更好的类型安全性和开发体验,我们应该显式指定 JSON 列的类型。Drizzle ORM 提供了 $type 方法来定义具体的类型:

interface TestObject {
  name: string;
  value: number;
  isActive: boolean;
}

export const testTable = pgTable("testTable", {
  id: text("id").primaryKey().notNull(),
  testobject: json('testobject').$type<TestObject>().array()
});

通过这种方式,TypeScript 编译器就能正确识别 JSON 列的类型,提供更好的代码提示和类型检查。

JSON 数据的序列化注意事项

在使用 JSON 列时,需要注意以下几点关于数据序列化的问题:

  1. 不需要手动调用 JSON.stringify() - Drizzle ORM 会自动处理序列化过程
  2. 确保数据可序列化 - 避免包含函数、循环引用或不可序列化的对象
  3. 日期对象处理 - 虽然 Date 对象有 toString() 方法,但最好先转换为字符串或时间戳

如果遇到 "Value is not JSON serializable" 错误,建议实现一个数据转换层,确保插入数据库的数据都是可序列化的。

最佳实践

  1. 始终为 JSON 列指定类型 - 这能显著提高代码的可维护性
  2. 使用接口定义类型 - 而不是直接使用内联类型,便于复用
  3. 实现数据验证 - 在应用层验证 JSON 数据的结构
  4. 考虑使用 JSONB - 如果需要进行查询操作,JSONB 类型通常性能更好

通过遵循这些实践,可以确保在使用 Drizzle ORM 处理 JSON 数据时既安全又高效。

登录后查看全文
热门项目推荐

项目优选

收起
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
176
261
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
861
511
ShopXO开源商城ShopXO开源商城
🔥🔥🔥ShopXO企业级免费开源商城系统,可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存,遵循MIT开源协议发布、基于ThinkPHP8框架研发
JavaScript
93
15
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
129
182
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
259
300
kernelkernel
deepin linux kernel
C
22
5
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
596
57
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.07 K
0
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
398
371
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
332
1.08 K