JSON.ARRAPPEND - Amazon ElastiCache

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

JSON.ARRAPPEND

Ajoute une ou plusieurs valeurs aux valeurs du tableau au niveau du chemin.

Syntaxe

JSON.ARRAPPEND <key> <path> <json> [json ...]

  • clé (obligatoire) — Une clé Valkey ou Redis de OSS type JSON document.

  • chemin (obligatoire) — Un JSON chemin.

  • json (obligatoire) — La JSON valeur à ajouter au tableau.

Retour

Si le chemin est une syntaxe améliorée :

  • Tableau d'entiers qui représentent la nouvelle longueur du tableau au niveau de chaque chemin.

  • Si une valeur n'est pas un tableau, sa valeur de retour correspondante est nulle.

  • SYNTAXERRerreur si l'un des arguments json d'entrée n'est pas une JSON chaîne valide.

  • Erreur NONEXISTENT si le chemin n'existe pas.

Si le chemin est une syntaxe restreinte :

  • Entier, la nouvelle longueur du tableau.

  • Si plusieurs valeurs de tableau sont sélectionnées, la commande renvoie la nouvelle longueur du dernier tableau mis à jour.

  • Erreur WRONGTYPE si la valeur au niveau du chemin n'est pas un tableau.

  • SYNTAXERRerreur si l'un des arguments json d'entrée n'est pas une JSON chaîne valide.

  • Erreur NONEXISTENT si le chemin n'existe pas.

Exemples

Syntaxe de chemin améliorée :

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\"]]"

Syntaxe de chemin restreinte :

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\"]]"