当前位置: 首页 > news >正文

RedisJSON 路径语法深度解析与实战

一、两种路径语法概览

语法类型触发标志简介
JSONPath$ 开头全功能路径,支持递归 (..)、通配符 (*)、切片 ([start:end:step])、过滤 (?())、脚本表达式等
Legacy. 或键名开头早期版本(v1)遗留语法,只支持简单的点式和中括号,不支持通配符/过滤

RedisJSON 会根据第一个字符自动判断:

  • $ 开头 → JSONPath
  • 否则 → Legacy

二、JSONPath 语法要点

语法功能
$根节点
.[]直接子节点选择
..递归搜索,匹配任意层级的同名字段
*通配符,匹配当前节点下所有子元素
[i]数组下标,支持负数(-1 表示最后一个)
[start:end:step]数组切片,如 [0:2][:3][::2]
[?()]过滤表达式,支持比较运算符 ==,!=,<,<=,>,>=,=~ 以及逻辑运算 `&&,`
@当前元素引用,在过滤器内用 @.field 访问
()脚本表达式

提示:在 CLI 中,整个 JSONPath 通常要用单引号包裹,以免 Shell 把 $* 等展开。

三、Legacy 语法要点

  • 以点号 . 或直接键名开头(可省略根节点 .
  • 支持 a.b.ca["key-with-special"]a[0]a[-1]
  • 不支持通配符、递归、切片、过滤等高级特性

四、实战示例

假设已在 Redis 中载入以下文档(键名 bikes:inventory,见你的示例):

# 省略 JSON.SET 代码,假设文档已存在

1. 基本查询

# 获取整个 inventory 下所有子数组(mountain_bikes、commuter_bikes)
JSON.GET bikes:inventory '$.inventory.*'

2. 提取所有山地车型号

JSON.GET bikes:inventory '$.inventory.mountain_bikes[*].model'
# 或
JSON.GET bikes:inventory '$..mountain_bikes[*].model'
# 返回 ["Phoebe","Quaoar","Weywot"]

3. 递归查询

# 查找所有 model 字段
JSON.GET bikes:inventory '$..model'
# 返回 ["Phoebe","Quaoar","Weywot","Salacia","Mimas"]

4. 数组切片

# 前两个山地车
JSON.GET bikes:inventory '$.inventory.mountain_bikes[0:2].model'
# 返回 ["Phoebe","Quaoar"]

5. 过滤表达式

# 价格 < 3000 且 重量 < 10 的山地车
JSON.GET bikes:inventory '$..mountain_bikes[?(@.price < 3000 && @.specs.weight < 10)]'
# 材料为 alloy 的所有车型型号
JSON.GET bikes:inventory '$..[?(@.specs.material == "alloy")].model'
# 返回 ["Weywot","Mimas"]
# 正则匹配材料以 "al-" 开头(v2.4.2+ 支持 =~)
JSON.GET bikes:inventory '$..[?(@.specs.material =~ "(?i)al")].model'
# 返回 ["Quaoar","Weywot","Salacia","Mimas"]

6. 更新与增删

# 所有价格统一减 100 / 加 100
JSON.NUMINCRBY bikes:inventory '$..price' -100
JSON.NUMINCRBY bikes:inventory '$..price'  100
# 对价格 <2000 的车型,设为 1500
JSON.SET bikes:inventory '$.inventory.*[?(@.price<2000)].price' 1500
# 向所有价格 <2000 的 colors 数组追加 "pink"
JSON.ARRAPPEND bikes:inventory '$.inventory.*[?(@.price<2000)].colors' '"pink"'

五、Legacy 语法示例

# 等同于 $.inventory.mountain_bikes[0].model
JSON.GET bikes:inventory .inventory.mountain_bikes[0].model
# 或
JSON.GET bikes:inventory inventory["mountain_bikes"][1].model

六、性能与注意事项

  1. 定位开销:路径深度越深、对象键越多、过滤条件越复杂,查询时间越长;推荐预先 JSON.GET 小范围字段或使用聚合后端做二次过滤。

  2. 过滤器正则=~ 支持 PCRE 风格,默认部分匹配,需精确匹配请在模式前后加 ^$

  3. 路径返回格式

    • 单路径 → 顶层返回数组
    • 多路径 → 返回对象,每个路径对应一个数组
  4. CLI 转义:Windows PowerShell 与 Bash 对引号处理不同,必要时可多层转义或改用客户端 SDK。

通过掌握上述示例与要点,你就能灵活使用 RedisJSON 强大的路径查询和更新能力,实现对嵌套 JSON 的高效操作。祝编程愉快!

http://www.dtcms.com/a/272582.html

相关文章:

  • Spring Boot + Javacv-platform:解锁音视频处理的多元场景
  • 【TCP/IP】12. 文件传输协议
  • MySQL索引操作全指南:创建、查看、优化
  • Debian-10编译安装Mysql-5.7.44 笔记250706
  • macOS 上安装 Miniconda + Conda-Forge
  • Jekyll + Chirpy + GitHub Pages 搭建博客
  • 如何使用Java WebSocket API实现客户端和服务器端的通信?
  • 蓝桥杯第十六届(2025)真题深度解析:思路复盘与代码实战
  • MinerU将PDF转成md文件,并分拣图片
  • Alibaba Druid主要配置
  • 图片合并pdf
  • 新手向:实现ATM模拟系统
  • TDengine 数据库建模最佳实践
  • Oracle 视图
  • Tomcat:Java Web应用的幕后英雄
  • 线性探针是什么:是一种用于探测神经网络中特定特征的工具
  • 从零开始搭建深度学习大厦系列-3.卷积神经网络基础(5-9)
  • 李宏毅(深度学习)--(2)
  • 数据库复合索引设计:为什么等值查询列应该放在范围查询列前面?
  • 区间动态规划详解
  • 【JMeter】跨线程组传递参数
  • 在Docker中运行macOS的超方便体验!
  • SpringAI×Ollama:Java生态无缝集成本地大模型实践指南
  • Redis数据库基础概述
  • 8.2.3希尔排序
  • Spring for Apache Pulsar->Reactive Support->Message Production
  • KV Cache原理详解 + 代码理解
  • 从零实现一个GPT 【React + Express】--- 【2】实现对话流和停止生成
  • Pytest之收集用例规则与运行指定用例
  • 外贸网站模板 网页设计模板网站