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

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

JSON.ARRINSERT

在索引之前的路径处向数组值插入一个或多个值。

语法

JSON.ARRINSERT <key> <path> <index> <json> [json ...]
  • 密钥(必需)— JSON 文档类型的 Redis 密钥

  • 路径(必需)— 一个 JSON 路径

  • index(必需)— 在其中插入值的数组索引。

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

返回值

如果路径是增强的语法:

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

  • 如果值为空数组,则其对应的返回值为 null。

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

  • OUTOFBOUNDARIES如果索引参数超出了界限,则错误。

如果路径是受限语法:

  • 整数,数组的新长度。

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

  • OUTOFBOUNDARIES如果索引参数超出了界限,则错误。

示例

增强路径语法:

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

受限语法:

127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]' OK 127.0.0.1:6379> JSON.ARRINSERT k1 . 0 '"c"' (integer) 4 127.0.0.1:6379> JSON.GET k1 "[\"c\",[],[\"a\"],[\"a\",\"b\"]]"