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

JSON.ARRAPPEND

将一个或多个值附加到路径上的数组值。

语法

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

  • path(必需)– 一个 JSON 路径。

  • json(必需)– 要附加到数组的 JSON 值。

返回值

如果路径是增强的语法:

  • 表示每个路径处数组的新长度的整数数组。

  • 如果值不是数组,则其对应的返回值为 Null。

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

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

如果路径是受限的语法:

  • 整数,该数组的新长度。

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

  • 如果路径中的值不是数组,则为 WRONGTYPE 错误。

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

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

示例

增强的路径语法:

127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]' OK 127.0.0.1:6379> JSON.ARRAPPEND k1 $[*] '"c"' 1) (integer) 1 2) (integer) 2 3) (integer) 3 127.0.0.1:6379> JSON.GET k1 "[[\"c\"],[\"a\",\"c\"],[\"a\",\"b\",\"c\"]]"

受限的路径语法:

127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]' OK 127.0.0.1:6379> JSON.ARRAPPEND k1 [-1] '"c"' (integer) 3 127.0.0.1:6379> JSON.GET k1 "[[],[\"a\"],[\"a\",\"b\",\"c\"]]"