Materialize项目中的jsonb类型深度解析

虞旋律

于 2025-06-07 09:06:37 发布

阅读量267

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.csdn.net/gitblog_00888/article/details/148488735

Materialize项目中的jsonb类型深度解析

什么是jsonb类型

jsonb是Materialize项目中用于表示JSON文档的二进制格式数据类型。与传统的文本JSON不同，jsonb以分解的二进制格式存储，这使得查询处理更加高效。

jsonb类型基础特性

jsonb类型具有以下核心特点：

二进制存储：数据以分解后的二进制格式存储，而非原始文本
高效查询：支持快速路径查询和索引操作
完整JSON支持：可以表示所有标准JSON元素类型
类型安全：在查询时保留原始JSON的类型信息

jsonb支持的数据元素

jsonb类型可以包含以下类型的元素：

对象：键值对集合，如 {"name": "张三", "age": 30}
数组：有序值列表，如 [1, 2, 3, 4]
字符串：如 "这是一个字符串"
数字：包括整数和小数，如 42 或 3.14159
布尔值：true 或 false
空值：null

jsonb操作符详解

Materialize提供了丰富的操作符来处理jsonb数据：

字段访问操作符

-> 操作符：获取jsonb字段值，返回jsonb类型

SELECT '{"name": "李四", "age": 25}'::jsonb->'name';
-- 返回: "李四" (jsonb类型)

->> 操作符：获取jsonb字段值，返回text类型

SELECT '{"name": "李四", "age": 25}'::jsonb->>'name';
-- 返回: 李四 (text类型)

路径访问操作符

#> 操作符：使用路径表达式获取jsonb值

SELECT '{"user": {"name": "王五", "details": {"age": 28}}}'::jsonb #> '{user,details,age}';
-- 返回: 28 (jsonb类型)

#>> 操作符：使用路径表达式获取text值

SELECT '{"user": {"name": "王五"}}'::jsonb #>> '{user,name}';
-- 返回: 王五 (text类型)

其他实用操作符

||：合并两个jsonb对象
-：从jsonb对象中移除指定键
@>：检查左操作数是否包含右操作数
<@：检查右操作数是否包含左操作数
?：检查jsonb对象是否包含指定键

jsonb函数大全

Materialize提供了一系列强大的jsonb处理函数：

数组处理函数

jsonb_array_elements：展开jsonb数组为多行

SELECT * FROM jsonb_array_elements('[1, "a", true]'::jsonb);

jsonb_array_length：获取jsonb数组长度

SELECT jsonb_array_length('[1, 2, 3]'::jsonb);
-- 返回: 3

对象处理函数

jsonb_object_keys：获取jsonb对象的所有键

SELECT * FROM jsonb_object_keys('{"a":1, "b":2}'::jsonb);

jsonb_each：将jsonb对象展开为键值对

SELECT * FROM jsonb_each('{"name":"赵六","age":30}'::jsonb);

构建函数

jsonb_build_array：从参数构建jsonb数组

SELECT jsonb_build_array(1, 'a', true);
-- 返回: [1, "a", true]

jsonb_build_object：从键值对构建jsonb对象

SELECT jsonb_build_object('id', 1, 'name', '钱七');
-- 返回: {"id":1, "name":"钱七"}

实用函数

jsonb_pretty：格式化输出jsonb

SELECT jsonb_pretty('{"a":1,"b":[2,3]}'::jsonb);

jsonb_typeof：获取jsonb元素的类型

SELECT jsonb_typeof('{"a":1}'::jsonb);
-- 返回: object

jsonb_strip_nulls：移除jsonb中的null值

SELECT jsonb_strip_nulls('{"a":1,"b":null}'::jsonb);
-- 返回: {"a":1}

类型转换与注意事项

从jsonb转换

jsonb可以显式转换为以下类型：

boolean
numeric
int
real/double precision
text

转换为jsonb

可以从text类型显式转换为jsonb：

SELECT '{"key":"value"}'::text::jsonb;

特殊转换情况

jsonb转text：保留JSON的原始格式，包括引号
```
SELECT ('"text"'::jsonb)::text;
-- 返回: "text"
```

->>操作符：去除字符串值的引号

SELECT ('"text"'::jsonb)->>0;
-- 返回: text

实际应用示例

示例1：处理嵌套JSON数据

SELECT 
    user_data->>'name' AS name,
    (user_data->>'age')::int AS age,
    user_data->'address'->>'city' AS city
FROM (SELECT '{"name":"孙八","age":35,"address":{"city":"北京","street":"市中心主干道"}}'::jsonb AS user_data) t;

示例2：展开JSON数组并与原始数据关联

SELECT 
    t.id,
    elem->>'product' AS product,
    (elem->>'price')::numeric AS price
FROM (
    VALUES 
    (1, '[{"product":"手机","price":2999},{"product":"耳机","price":599}]'::jsonb),
    (2, '[{"product":"笔记本","price":5999}]'::jsonb)
) AS t(id, products)
CROSS JOIN jsonb_array_elements(t.products) AS elem;