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 文档许可。