JSON.SET

在给定路径设置 JSON 值。

• 如果路径指向一个对象成员
  • 如果父元素不存在，命令将返回 NONEXISTENT 错误。
  • 如果父元素存在但不是一个对象，命令将返回 ERROR 错误。
  • 如果父元素存在且是一个对象
    • 如果成员不存在，当且仅当父对象是路径中的最后一个子元素时，新成员将被添加到父对象。否则，命令将返回 NONEXISTENT 错误。
    • 如果成员存在，其值将被新的 JSON 值替换。
• 如果路径指向一个数组索引
  • 如果父元素不存在，命令将返回 NONEXISTENT 错误。
  • 如果父元素存在但不是一个数组，命令将返回 ERROR 错误。
  • 如果父元素存在但索引超出范围，命令将返回 OUTOFBOUNDARIES 错误。
  • 如果父元素存在且索引有效，该元素将被新的 JSON 值替换。
• 如果路径指向一个对象或数组，该值（对象或数组）将被新的 JSON 值替换。

示例

增强路径语法

127.0.0.1:6379> JSON.SET k1 . '{"a":{"a":1, "b":2, "c":3}}'
OK
127.0.0.1:6379> JSON.SET k1 $.a.* '0'
OK
127.0.0.1:6379> JSON.GET k1
"{\"a\":{\"a\":0,\"b\":0,\"c\":0}}"

127.0.0.1:6379> JSON.SET k2 . '{"a": [1,2,3,4,5]}'
OK
127.0.0.1:6379> JSON.SET k2 $.a[*] '0'
OK
127.0.0.1:6379> JSON.GET k2
"{\"a\":[0,0,0,0,0]}"

受限路径语法

127.0.0.1:6379> JSON.SET k1 . '{"c":{"a":1, "b":2}, "e": [1,2,3,4,5]}'
OK
127.0.0.1:6379> JSON.SET k1 .c.a '0'
OK
127.0.0.1:6379> JSON.GET k1
"{\"c\":{\"a\":0,\"b\":2},\"e\":[1,2,3,4,5]}"
127.0.0.1:6379> JSON.SET k1 .e[-1] '0'
OK
127.0.0.1:6379> JSON.GET k1
"{\"c\":{\"a\":0,\"b\":2},\"e\":[1,2,3,4,0]}"
127.0.0.1:6379> JSON.SET k1 .e[5] '0'
(error) OUTOFBOUNDARIES Array index is out of bounds

RESP2 回复

• 简单字符串回复：成功时返回 'OK'。

• 空回复：如果 NX 或 XX 条件不满足。

RESP3 回复

• 简单字符串回复：成功时返回 'OK'。

• Null 回复：如果 NX 或 XX 条件不满足。