本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
JSON.ARRAPPEND
将一个或多个值附加到路径上的数组值。
语法
JSON.ARRAPPEND <key> <path> <json> [json ...]
-
密钥(必填)— JSON 文档类型的 Valkey 或 Redis OSS 密钥。
-
路径(必填)-JSON 路径。
-
json(必填)-要附加到数组的JSON值。
Return
如果路径是增强的语法:
-
表示每个路径处数组的新长度的整数数组。
-
如果值不是数组,则其对应的返回值为 Null。
-
SYNTAXERR
如果其中一个输入 json 参数不是有效的JSON字符串,则出错。 -
如果路径不存在,则为
NONEXISTENT
错误。
如果路径是受限的语法:
-
整数,该数组的新长度。
-
如果选择了多个数组值,该命令将返回上次更新数组的新长度。
-
如果路径中的值不是数组,则为
WRONGTYPE
错误。 -
SYNTAXERR
如果其中一个输入 json 参数不是有效的JSON字符串,则出错。 -
如果路径不存在,则为
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\"]]"