JSON.NUMINCRBY
将路径中存储的数字值按数字递增
语法
JSON.NUMINCRBY key path value
引入版本:1.0.0
复杂度摘要:O(1)
将 path 中存储的数值增加 value
必需参数
key
修改关键。
path
是JSONPath来指定。
value
是要增加的数值。
示例
Increment number values
创建一个文档。
redis> JSON.SET 文档。 '{"a":"b","b":[{"a":2}, {"a":5}, {"a":"c"}]}' 好的
将 a 对象的值增加 2。该命令找不到数字并返回 null。
redis> JSON.NUMINCRBY doc $.a 2 "[null]"
递归查找并递增所有 a 对象的值。该命令递增它找到的数字,并为非数字值返回 null。
redis> JSON.NUMINCRBY doc $..a 2 "[null,4,7,null]"
Redis Software 与 Redis Cloud 兼容性
| Redis 软件 |
Redis Cloud |
说明 |
|---|---|---|
| ✅ 支持 |
✅ 灵活且每年一次 ✅ 免费和固定 |
返回值
RESP2
使用基于 $ 的路径参数:批量字符串回复 包含一个 JSON 数组,每个匹配路径有一个元素:新值;如果匹配值不是数字,则为 null。如果没有路径匹配,则数组为空。
使用基于 . 的路径参数:批量字符串回复 表示字符串化的新值。如果路径匹配多个数字,该命令将更新所有数字并返回最后一个新值。如果没有匹配值是数字,则 简单错误回复。
使用任一路径参数:如果键不存在或结果超出范围,则为 简单错误回复。
RESP3
路径语法不会改变回复。 数组回复 每个匹配路径有一个元素:包含新值的 整数回复 或 双重回复,或者如果匹配值不是数字,则为 空回复。如果没有路径匹配,则数组为空。
如果键不存在或结果超出范围,则返回 简单错误回复。
参见
JSON.ARRINDEX | JSON.ARRINSERT
相关主题
资料来源:Redis 官方 JSON.NUMINCRBY 文档;中文内容参考 Redis 文档许可。