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.

JSONvue d'ensemble des types de données

ElastiCache prend en charge un certain nombre de OSS commandes Valkey et Redis pour travailler avec le type de JSON données. Vous trouverez ci-dessous un aperçu du type de JSON données et une liste détaillée des commandes prises en charge.

Terminologie

JSONNorme prise en charge

JSONle format est conforme aux normes d'échange de JSON données RFC7159 et ECMA-404. UTF-8 L'Unicode dans le JSON texte est pris en charge.

Élément racine

L'élément racine peut être de n'importe quel type de JSON données. Notez que dans la version RFC 4627 antérieure, seuls les objets ou les tableaux étaient autorisés en tant que valeurs racines. Depuis la mise à jour vers la RFC version 7159, la racine d'un JSON document peut être de n'importe quel type de JSON données.

Limite de taille du document

JSONles documents sont stockés en interne dans un format optimisé pour un accès et une modification rapides. Ce format entraîne généralement une consommation de mémoire un peu plus importante que la représentation sérialisée équivalente du même document.

La consommation de mémoire par un seul JSON document est limitée à 64 Mo, ce qui correspond à la taille de la structure de données en mémoire, et non à la JSON chaîne. Vous pouvez vérifier la quantité de mémoire consommée par un JSON document à l'aide de la JSON.DEBUG MEMORY commande.

JSON ACLs

Limite de profondeur d'imbrication

Lorsqu'un JSON objet ou un tableau possède un élément qui est lui-même un autre JSON objet ou tableau, on dit que cet objet ou ce tableau interne « s'imbrique » dans l'objet ou le tableau extérieur. La limite maximale de la profondeur d'imbrication est de 128. Toute tentative de création d'un document contenant une profondeur d'imbrication supérieure à 128 sera rejetée avec une erreur.

Syntaxe de commande

La plupart des commandes nécessitent un nom de clé comme premier argument. Certaines commandes ont également un argument path. L'argument path correspond par défaut à la racine s'il est optionnel et non fourni.

Notation :

Syntaxe de chemin

Redis JSON prend en charge deux types de syntaxes de chemin :

Si un chemin de requête commence par « $ », il utilise la syntaxe améliorée. Sinon, la syntaxe restreinte est utilisée.

Syntaxe améliorée

Exemples

Les exemples suivants sont basés sur les XML données d'exemple de Goessner, que nous avons modifiées en ajoutant des champs supplémentaires.

{ "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
    }
  }
}

Exemples d'expressions de filtre supplémentaires :

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

Syntaxe restreinte

Exemples

Préfixes d'erreur courantes

Chaque message d'erreur possède un préfixe. Voici une liste des préfixes d'erreur courants.

JSONmétriques associées

Les indicateurs JSON d'information suivants sont fournis :

Pour interroger les métriques de base, exécutez la commande suivante :

info json_core_metrics

Comment ElastiCache avec Valkey et Redis interagissent-ils OSS avec JSON

La section suivante décrit comment ElastiCache Valkey et Redis OSS interagissent avec le JSON type de données.

Priorité des opérateurs

Lors de l'évaluation d'expressions conditionnelles pour le filtrage, les && sont prioritaires, puis les || sont évalués, comme c'est le cas dans la plupart des langages. Les opérations à l'intérieur des parenthèses sont exécutées en premier.

Comportement de la limite maximale d'imbrication des chemins

La limite maximale d'imbrication de chemins dans ElastiCache (RedisOSS) est de 128. Ainsi, une valeur comme $.a.b.c.d... ne peut atteindre que 128 niveaux.

Traitement des valeurs numériques

JSONn'a pas de types de données distincts pour les nombres entiers et les nombres à virgule flottante. Ils sont tous appelés des nombres.

Représentations numériques :

Lorsqu'un JSON nombre est reçu en entrée, il est converti en l'une des deux représentations binaires internes : un entier signé de 64 bits ou un nombre à virgule flottante à IEEE double précision de 64 bits. La chaîne de caractères d'origine et toute sa mise en forme ne sont pas retenues. Ainsi, lorsqu'un nombre est généré dans le cadre d'une JSON réponse, il est converti de la représentation binaire interne en une chaîne imprimable qui utilise des règles de formatage génériques. Ces règles peuvent entraîner la génération d'une chaîne différente de celle qui a été reçue.

Commandes arithmétiques NUMINCRBY et NUMMULTBY :

Pour une liste détaillée des commandes disponibles, consultez Commandes Valkey et Redis OSS prises en charge.

Filtrage direct de tableau

ElastiCache avec Valkey ou Redis, OSS filtre directement les objets de la matrice.

Pour des données comme [0,1,2,3,4,5,6] et une requête de chemin comme$[?(@<4)], ou des données similaires {"my_key":[0,1,2,3,4,5,6]} et une requête de chemin comme$.my_key[?(@<4)], ElastiCache avec Valkey ou RedisOSS, nous renverrons [1,2,3] dans les deux cas.

Comportement d'indexation de tableau

ElastiCache avec Valkey ou Redis OSS permet des indices positifs et négatifs pour les tableaux. Pour un tableau de longueur cinq, 0 interrogerait le premier élément, 1 le deuxième, et ainsi de suite. Les nombres négatifs commencent à la fin du tableau, donc -1 interrogerait le cinquième élément, -2 le quatrième élément, et ainsi de suite.

Pour garantir un comportement prévisible aux clients, ElastiCache Valkey ou Redis n'arrondit OSS pas les index des tableaux vers le bas ou vers le haut. Ainsi, si vous avez un tableau d'une longueur de 5, le fait d'appeler l'index 5 ou plus, ou -6 ou moins, ne produira aucun résultat.

Évaluation stricte de la syntaxe

MemoryDB n'autorise pas les JSON chemins dont la syntaxe n'est pas valide, même si un sous-ensemble du chemin contient un chemin valide. Ceci afin de maintenir un comportement correct pour nos clients.