*Redis JSON.NUMINCRBY 命令
JSON.NUMINCRBY 在 RedisJSON 中对指定路径的数字值执行原子性递增。
*语法
JSON.NUMINCRBY key path number
*参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | String | 是 | JSON 文档键名 |
| path | String | 是 | JSONPath 路径 |
| number | Integer/Float | 是 | 增量值 |
*返回值
- String：递增后的新值
- Error：路径不存在或不是数字
*时间复杂度
O(1)
*
*示例
*基本用法
> JSON.SET doc $ '{"counter": 10}'
OK
> JSON.NUMINCRBY doc $.counter 5
"15"
> JSON.NUMINCRBY doc $.counter -3
"12"
*常见错误
| 错误 | 原因 | 解决 |
|---|---|---|
| ERR path does not exist | 路径不存在 | 确认路径正确 |
| ERR path not a number | 目标不是数字 | 确认路径指向数字 |
*最佳实践
- 用于计数器场景
- 支持负增量实现递减
- 原子性操作，无需 WATCH
*FAQ
Q1: 支持浮点数吗？ A: 支持，可以递增浮点数。
Q2: 路径不存在会怎样？ A: 会返回错误。
Q3: 和 JSON.NUMMULTBY 有什么区别？ A: NUMINCRBY 是加法；NUMMULTBY 是乘法。