JSON.STRAPPEND - Amazon ElastiCache for Redis
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

JSON.STRAPPEND

将字符串附加到路径的 JSON 字符串。

语法

JSON.STRAPPEND <key> [path] <json_string>
  • key(必需)– JSON 文档类型的 Redis 键。

  • path(可选)– 一个 JSON 路径。如果未提供,则默认为根目录。

  • json_string(必需)– 字符串的 JSON 表示。请注意,JSON 字符串必须用引号括起来。例如: '"string example"'。

返回值

如果路径是增强的语法:

  • 表示每个路径字符串的新长度的整数数组。

  • 如果路径上的值不是字符串,其对应的返回值为 Null。

  • SYNTAXERR 如果输入 json 参数不是有效的 JSON 字符串,则为 错误。

  • NONEXISTENT 如果路径不存在,则为 错误。

如果路径是受限的语法:

  • 整数,该字符串的新长度。

  • 如果选择了多个字符串值,该命令将返回上次更新字符串的新长度。

  • 如果路径中的值不是字符串,则为 WRONGTYPE 错误。

  • 如果输入 json 参数不是有效的 JSON 字符串,则为 WRONGTYPE 错误。

  • 如果路径不存在,则为 NONEXISTENT 错误。

示例

增强的路径语法:

127.0.0.1:6379> JSON.SET k1 $ '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":3}}' OK 127.0.0.1:6379> JSON.STRAPPEND k1 $.a.a '"a"' 1) (integer) 2 127.0.0.1:6379> JSON.STRAPPEND k1 $.a.* '"a"' 1) (integer) 3 127.0.0.1:6379> JSON.STRAPPEND k1 $.b.* '"a"' 1) (integer) 2 2) (nil) 127.0.0.1:6379> JSON.STRAPPEND k1 $.c.* '"a"' 1) (integer) 2 2) (integer) 3 127.0.0.1:6379> JSON.STRAPPEND k1 $.c.b '"a"' 1) (integer) 4 127.0.0.1:6379> JSON.STRAPPEND k1 $.d.* '"a"' 1) (nil) 2) (integer) 2 3) (nil)

受限的路径语法:

127.0.0.1:6379> JSON.SET k1 . '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":3}}' OK 127.0.0.1:6379> JSON.STRAPPEND k1 .a.a '"a"' (integer) 2 127.0.0.1:6379> JSON.STRAPPEND k1 .a.* '"a"' (integer) 3 127.0.0.1:6379> JSON.STRAPPEND k1 .b.* '"a"' (integer) 2 127.0.0.1:6379> JSON.STRAPPEND k1 .c.* '"a"' (integer) 3 127.0.0.1:6379> JSON.STRAPPEND k1 .c.b '"a"' (integer) 4 127.0.0.1:6379> JSON.STRAPPEND k1 .d.* '"a"' (integer) 2