JSON.ARRAPPEND - Amazon ElastiCache

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

JSON.ARRAPPEND

Hängen Sie einen oder mehrere Werte für die Array-Werte an den Pfad an.

Syntax

JSON.ARRAPPEND <key> <path> <json> [json ...]
  • key (erforderlich) — Ein Valkey- oder OSS Redis-Schlüssel des JSON Dokumenttyps.

  • path (erforderlich) — Ein JSON Pfad.

  • json (erforderlich) — Der JSON Wert, der an das Array angehängt werden soll.

Ergebnis

Wenn der Pfad eine erweiterte Syntax ist:

  • Array von Ganzzahlen, die die neue Länge des Arrays bei jedem Pfad darstellen.

  • Wenn ein Wert kein Array ist, ist der entsprechende Rückgabewert Null.

  • SYNTAXERRFehler, wenn eines der JSON-Eingabeargumente keine gültige JSON Zeichenfolge ist.

  • NONEXISTENT-Fehler, wenn der Pfad nicht vorhanden ist.

Wenn der Pfad eine eingeschränkte Syntax hat:

  • Ganzzahl, die neue Länge des Arrays.

  • Wenn mehrere Array-Werte ausgewählt wurden, gibt der Befehl die neue Länge des zuletzt aktualisierten Arrays zurück.

  • WRONGTYPE-Fehler, wenn der Wert im Pfad kein Array ist.

  • SYNTAXERRFehler, wenn eines der JSON-Eingabeargumente keine gültige JSON Zeichenfolge ist.

  • NONEXISTENT-Fehler, wenn der Pfad nicht vorhanden ist.

Beispiele

Erweiterte Pfad-Syntax:

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

Eingeschränkte Pfad-Syntax:

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