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Überblick über Datentypen

ElastiCache unterstützt eine Reihe von Valkey- und OSS Redis-Befehlen für die Arbeit mit dem JSON Datentyp. Im Folgenden finden Sie eine Übersicht über den JSON Datentyp und eine detaillierte Liste der unterstützten Befehle.

Terminologie

Unterstützter JSON Standard

JSONDas Format entspricht den RFCJSONDatenaustauschstandards 7159 und ECMA-404. UTF-8 Unicode im JSON Text wird unterstützt.

Stammelement

Das Stammelement kann einen beliebigen JSON Datentyp haben. Beachten Sie, dass in früheren Versionen der Version RFC 4627 nur Objekte oder Arrays als Stammwerte zulässig waren. Seit der Aktualisierung auf Version RFC 7159 kann das Stammverzeichnis eines JSON Dokuments einen beliebigen JSON Datentyp haben.

Begrenzung der Dokumentgröße

JSONDokumente werden intern in einem Format gespeichert, das für schnellen Zugriff und Änderungen optimiert ist. Dieses Format führt in der Regel dazu, dass etwas mehr Speicher verbraucht wird als bei der äquivalenten serialisierten Darstellung desselben Dokuments.

Der Speicherverbrauch eines einzelnen JSON Dokuments ist auf 64 MB begrenzt. Dies entspricht der Größe der speicherinternen Datenstruktur, nicht der JSON Zeichenfolge. Mit dem JSON.DEBUG MEMORY Befehl können Sie überprüfen, wie viel Speicherplatz ein JSON Dokument belegt.

JSON ACLs

Begrenzung der Verschachtelungstiefe

Wenn ein JSON Objekt oder eine Reihe ein Element hat, das selbst ein anderes JSON Objekt oder Array ist, wird gesagt, dass dieses innere Objekt oder Array innerhalb des äußeren Objekts oder der äußeren Anordnung „verschachtelt“ ist. Die maximale Verschachtelungstiefe ist 128. Jeder Versuch, ein Dokument zu erstellen, das eine Verschachtelungstiefe von mehr als 128 enthält, wird mit einem Fehler abgelehnt.

Befehlssyntax

Die meisten Befehle erfordern einen Schlüsselnamen als erstes Argument. Einige Befehle haben auch ein Pfadargument. Das Pfadargument ist standardmäßig das Stammverzeichnis, wenn es optional und nicht im Lieferumfang enthalten ist.

Notation:

Pfadsyntax

Redis JSON unterstützt zwei Arten von Pfadsyntaxen:

Wenn ein Abfragepfad mit „$“ beginnt, verwendet er die erweiterte Syntax. Andernfalls wird eine eingeschränkte Syntax verwendet.

Verbesserte Syntax

Beispiele

Die folgenden Beispiele basieren auf den XML Beispieldaten von Goessner, die wir durch das Hinzufügen zusätzlicher Felder modifiziert haben.

{ "store": {
    "book": [ 
      { "category": "reference",
        "author": "Nigel Rees",
        "title": "Sayings of the Century",
        "price": 8.95,
        "in-stock": true,
        "sold": true
      },
      { "category": "fiction",
        "author": "Evelyn Waugh",
        "title": "Sword of Honour",
        "price": 12.99,
        "in-stock": false,
        "sold": true
      },
      { "category": "fiction",
        "author": "Herman Melville",
        "title": "Moby Dick",
        "isbn": "0-553-21311-3",
        "price": 8.99,
        "in-stock": true,
        "sold": false
      },
      { "category": "fiction",
        "author": "J. R. R. Tolkien",
        "title": "The Lord of the Rings",
        "isbn": "0-395-19395-8",
        "price": 22.99,
        "in-stock": false,
        "sold": false
      }
    ],
    "bicycle": {
      "color": "red",
      "price": 19.95,
      "in-stock": true,
      "sold": false
    }
  }
}

Zusätzliche Beispiele für Filterausdrücke:

127.0.0.1:6379> JSON.SET k1 . '{"books": [{"price":5,"sold":true,"in-stock":true,"title":"foo"}, {"price":15,"sold":false,"title":"abc"}]}'
OK
127.0.0.1:6379> JSON.GET k1 $.books[?(@.price>1&&@.price<20&&@.in-stock)]
"[{\"price\":5,\"sold\":true,\"in-stock\":true,\"title\":\"foo\"}]"
127.0.0.1:6379> JSON.GET k1 '$.books[?(@.price>1 && @.price<20 && @.in-stock)]'
"[{\"price\":5,\"sold\":true,\"in-stock\":true,\"title\":\"foo\"}]"
127.0.0.1:6379> JSON.GET k1 '$.books[?((@.price>1 && @.price<20) && (@.sold==false))]'
"[{\"price\":15,\"sold\":false,\"title\":\"abc\"}]"
127.0.0.1:6379> JSON.GET k1 '$.books[?(@.title == "abc")]'
[{"price":15,"sold":false,"title":"abc"}]

127.0.0.1:6379> JSON.SET k2 . '[1,2,3,4,5]'
127.0.0.1:6379> JSON.GET k2 $.*.[?(@>2)]
"[3,4,5]"
127.0.0.1:6379> JSON.GET k2 '$.*.[?(@ > 2)]'
"[3,4,5]"

127.0.0.1:6379> JSON.SET k3 . '[true,false,true,false,null,1,2,3,4]'
OK
127.0.0.1:6379> JSON.GET k3 $.*.[?(@==true)]
"[true,true]"
127.0.0.1:6379> JSON.GET k3 '$.*.[?(@ == true)]'
"[true,true]"
127.0.0.1:6379> JSON.GET k3 $.*.[?(@>1)]
"[2,3,4]"
127.0.0.1:6379> JSON.GET k3 '$.*.[?(@ > 1)]'
"[2,3,4]"

Beschränkte Syntax

Beispiele

Häufige Fehlerpräfixe

Jede Fehlermeldung hat ein Präfix. Im Folgenden finden Sie eine Liste mit allgemeinen Fehlerpräfixen.

JSONverwandte Metriken

Die folgenden JSON Informationsmetriken werden bereitgestellt:

Führen Sie den folgenden Befehl aus, um Kernmetriken abzufragen:

info json_core_metrics

Wie ElastiCache interagiert Valkey und Redis OSS mit JSON

Im folgenden Abschnitt wird beschrieben, wie Valkey und Redis ElastiCache mit dem Datentyp OSS interagieren. JSON

Rangfolge der Operatoren

Bei der Bewertung bedingter Ausdrücke zum Filtern, haben &&s zuerst Vorrang, und dann werden ||s ausgewertet, wie es in den meisten Sprachen üblich ist. Operationen innerhalb von Klammern werden zuerst ausgeführt.

Verhalten der maximalen Verschachtelungsbeschränkung

Das maximale Limit für die Verschachtelung von Pfaden in ElastiCache (OSSRedis) beträgt 128. Ein Wert wie $.a.b.c.d... kann also nur 128 Level erreichen.

Umgang mit numerischen Werten

JSONhat keine separaten Datentypen für Ganzzahlen und Fließkommazahlen. Sie werden alle Zahlen genannt.

Numerische Repräsentationen:

Wenn eine JSON Zahl bei der Eingabe empfangen wird, wird sie in eine der beiden internen Binärdarstellungen umgewandelt: eine 64-Bit-Ganzzahl mit Vorzeichen oder eine 64-Bit-Gleitkommazahl IEEE mit doppelter Genauigkeit. Die Ursprüngliche Zeichenfolge und alle ihre Formatierungen werden nicht beibehalten. Wenn also eine Zahl als Teil einer JSON Antwort ausgegeben wird, wird sie aus der internen Binärdarstellung in eine druckbare Zeichenfolge konvertiert, die generische Formatierungsregeln verwendet. Diese Regeln könnten dazu führen, dass eine andere Zeichenfolge generiert wird als empfangen wurde.

Arithmetische Befehle NUMINCRBY und NUMMULTBY:

Eine detaillierte Liste der verfügbaren Befehle finden Sie unter Unterstützte Valkey- und Redis-Befehle OSS.

Direktes Array-Filtern

ElastiCache mit Valkey oder Redis werden Array-Objekte direkt OSS gefiltert.

Bei Daten wie [0,1,2,3,4,5,6] und einer Pfadabfrage wie $[?(@<4)] oder Daten wie {"my_key":[0,1,2,3,4,5,6]} und einer Pfadabfrage wie $.my_key[?(@<4)] ElastiCache mit Valkey oder Redis OSS würde unter beiden Umständen [1,2,3] zurückgegeben werden.

Array-Indizierung

ElastiCache mit Valkey oder Redis sind sowohl positive als auch OSS negative Indizes für Arrays möglich. Bei einem Array mit der Länge fünf würde 0 das erste Element abfragen, 1 das zweite usw. Negative Zahlen beginnen am Ende des Arrays, also würde -1 das fünfte Element abfragen, -2 das vierte Element usw.

Um ein vorhersehbares Verhalten für Kunden sicherzustellen, ElastiCache rundet Valkey oder Redis Array-Indizes OSS nicht nach unten oder oben ab. Wenn Sie also ein Array mit einer Länge von 5 haben, würde der Aufruf von Index 5 oder höher oder -6 oder niedriger zu keinem Ergebnis führen.

Strikte Syntaxbewertung

MemoryDB erlaubt keine JSON Pfade mit ungültiger Syntax, selbst wenn eine Teilmenge des Pfads einen gültigen Pfad enthält. Dies soll für unsere Kunden ein korrektes Verhalten sicherstellen.