JSON.ARRINSERT - 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.ARRINSERT

Fügt einen oder mehrere Werte in die Array-Werte beim Pfad vor dem Index ein.

Syntax

JSON.ARRINSERT <key> <path> <index> <json> [json ...]
  • key (erforderlich) — Ein Valkey- oder OSS Redis-Schlüssel vom JSON Dokumenttyp.

  • path (erforderlich) — Ein JSON Pfad.

  • index (erforderlich) – Ein Array-Index, vor dem Werte eingefügt werden.

  • 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 ein leeres Array ist, ist der entsprechende Rückgabewert Null.

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

  • OUTOFBOUNDARIES-Fehler, wenn das Index-Argument außerhalb des gültigen Bereichs liegt.

Wenn der Pfad eine eingeschränkte Syntax hat:

  • Ganzzahl, die neue Länge des Arrays.

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

  • OUTOFBOUNDARIES-Fehler, wenn das Index-Argument außerhalb des gültigen Bereichs liegt.

Beispiele

Erweiterte Pfad-Syntax:

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

Eingeschränkte Pfad-Syntax:

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