JSONdescripción general de los tipos de datos

ElastiCache admite varios OSS comandos de Valkey y Redis para trabajar con el tipo de JSON datos. A continuación, se ofrece una descripción general del tipo de JSON datos y una lista detallada de los comandos compatibles.

Terminología

Plazo	Descripción
JSONdocumento	Hace referencia al valor de una JSON clave.
JSONvalor	Hace referencia a un subconjunto de un JSON documento, incluida la raíz que representa todo el documento. Un valor podría ser un contenedor o una entrada dentro de un contenedor.
JSONelemento	Equivalente al JSON valor.

JSONEstándar compatible

JSONEl formato cumple con los estándares de intercambio de JSON datos RFC7159 y ECMA-404. UTF-8 Se admite Unicode en el textoJSON.

Elemento raíz

El elemento raíz puede ser de cualquier tipo de JSON datos. Tenga en cuenta que en la versión anterior a la versión RFC 4627, solo se permitían objetos o matrices como valores raíz. Desde la actualización a la versión RFC 7159, la raíz de un JSON documento puede ser de cualquier tipo JSON de datos.

Límite de tamaño del documento

JSONlos documentos se almacenan internamente en un formato optimizado para un acceso y una modificación rápidos. Este formato suele consumir algo más de memoria que la representación serializada equivalente del mismo documento.

El consumo de memoria de un único JSON documento está limitado a 64 MB, que es el tamaño de la estructura de datos en memoria, no de la JSON cadena. Puede comprobar la cantidad de memoria que consume un JSON documento mediante el JSON.DEBUG MEMORY comando.

JSON ACLs

• De forma similar a las categorías existentes por tipo de datos (@string, @hash, etc.), se ha agregado una nueva categoría @json para simplificar la administración del acceso a JSON los comandos y los datos. Ningún otro OSS comando de Valkey o Redis existente forma parte de la categoría @json. Todos los JSON comandos imponen restricciones y permisos de espacio de teclas o comandos.

• Existen cinco OSS ACL categorías de Valkey y Redis que se han actualizado para incluir los nuevos JSON comandos: @read, @write, @fast, @slow y @admin. En la siguiente tabla se indica la asignación de los JSON comandos a las categorías correspondientes.

ACL
JSONcomando	@read	@write	@fast	@slow	@admin
JSON.ARRAPPEND		y	y
JSON.ARRINDEX	y		y
JSON.ARRINSERT		y	y
JSON.ARRLEN	y		y
JSON.ARRPOP		y	y
JSON.ARRTRIM		y	y
JSON.CLEAR		y	y
JSON.DEBUG	y			y	y
JSON.DEL		y	y
JSON.FORGET		y	y
JSON.GET	y		y
JSON.MGET	y		y
JSON.NUMINCRBY		y	y
JSON.NUMMULTBY		y	y
JSON.OBJKEYS	y		y
JSON.OBJLEN	y		y
JSON.RESP	y		y
JSON.SET		y		y
JSON.STRAPPEND		y	y
JSON.STRLEN	y		y
JSON.STRLEN	y		y
JSON.TOGGLE		y	y
JSON.TYPE	y		y
JSON.NUMINCRBY		y	y

Límite de profundidad de anidado

Cuando un JSON objeto o matriz tiene un elemento que es en sí mismo otro JSON objeto o matriz, se dice que ese objeto o matriz interno «anida» dentro del objeto o matriz exterior. El límite máximo de profundidad de anidamiento es 128. Cualquier intento de crear un documento que contenga una profundidad de anidamiento superior a 128 se rechazará con un error.

Sintaxis de comandos

La mayoría de los comandos requieren un nombre de clave como primer argumento. Algunos comandos también tienen un argumento ruta. El argumento ruta se establece por defecto en la raíz si es opcional y no proporcionado.

Notación:

• Los argumentos obligatorios se incluyen entre corchetes angulares. Por ejemplo: <key>

• Los argumentos opcionales deben ir entre corchetes. Por ejemplo: [path]

• Los argumentos opcionales adicionales se indican mediante puntos suspensivos (“...”). Por ejemplo: [json ...]

Sintaxis de ruta

Redis JSON admite dos tipos de sintaxis de rutas:

• Sintaxis mejorada: sigue la JSONPath sintaxis descrita por Goessner, como se muestra en la siguiente tabla. Hemos reordenado y modificado las descripciones de la tabla para mayor claridad.

• Sintaxis restringida: tiene capacidades de consulta limitadas.

nota

Los resultados de algunos comandos son sensibles al tipo de sintaxis de ruta que se utiliza.

Si una ruta de consulta comienza por '$', utiliza la sintaxis mejorada. De lo contrario, se utiliza la sintaxis restringida.

Sintaxis mejorada

Símbolo o expresión	Descripción
$	El elemento raíz.
. o bien []	Operador secundario.
..	Descenso recursivo.
*	Comodín. Todos los elementos de un objeto o matriz.
[]	Operador de subíndice de matriz. El índice se basa en 0.
[,]	Operador de unión.
[start:end:step]	Operador de Slice de la matriz.
?()	Aplica una expresión de filtro (script) a la matriz u objeto actual.
()	Expresión de filtro.
@	Se usa en expresiones de filtro que hacen referencia al nodo actual que se está procesando.
==	Igual a, se utiliza en las expresiones de filtro.
!=	No es igual a, se utiliza en las expresiones de filtro.
>	Mayor que, se utiliza en las expresiones de filtro.
>=	Mayor o igual que, se utiliza en las expresiones de filtro.
<	Menor que, se utiliza en expresiones de filtro.
<=	Menor o igual que, se utiliza en las expresiones de filtro.
&&	LógicoAND, se utiliza para combinar varias expresiones de filtro.
||	Lógico O, se utiliza para combinar múltiples expresiones de filtro.

Ejemplos

Los siguientes ejemplos se basan en los XML datos de ejemplo de Goessner, que hemos modificado añadiendo campos adicionales.

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

Ruta	Descripción
$.store.book[*].author	Los autores de todos los libros de la tienda.
$..author	Todos los autores.
$.store.*	Todos los miembros de la tienda.
$.store.*	Todos los miembros de la tienda.
$.store..price	El precio de todo lo que hay en la tienda.
$..*	Todos los miembros recursivos de la estructura. JSON
$..book[*]	Todos los libros.
$..book[0]	El primer libro.
$..book[-1]	El último libro.
$..book[0:2]	Los dos primeros libros.
$..book[0,1]	Los dos primeros libros.
$..book[0:4]	Los libros del índice 0 al 3 (el índice final no está incluido).
$..book[0:4:2]	Los libros en el índice 0, 2.
$..book[?(@.isbn)]	Todos los libros con un ISBN número.
$..book[?(@.price<10)]	Todos los libros que cuestan menos de 10 dólares.
'$..book[?(@.price < 10)]'	Todos los libros que cuestan menos de 10 dólares. (La ruta debe estar entre comillas si contiene espacios en blanco).
'$..book[?(@["price"] < 10)]'	Todos los libros que cuestan menos de 10 dólares.
'$..book[?(@.["price"] < 10)]'	Todos los libros que cuestan menos de 10 dólares.
$..book[?(@.price>=10&&@.price<=100)]	Todos los libros en el rango de precios de 10 a 100 dólares, incluidos.
'$..book[?(@.price>=10 && @.price<=100)]'	Todos los libros en el rango de precios de 10 a 100 dólares, incluidos. (La ruta debe estar entre comillas si contiene espacios en blanco).
$..book[?(@.sold==true||@.in-stock==false)]	Todos los libros vendidos o agotados.
'$..book[?(@.sold == true || @.in-stock == false)]'	Todos los libros vendidos o agotados. (La ruta debe estar entre comillas si contiene espacios en blanco).
'$.store.book[?(@.["category"] == "fiction")]'	Todos los libros de la categoría Ficción.
'$.store.book[?(@.["category"] != "fiction")]'	Todos los libros de las categorías que no sean ficción.

Ejemplos de expresiones de filtro adicionales:

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

Sintaxis restringida

Símbolo o expresión	Descripción
. o bien []	Operador secundario.
[]	Operador de subíndice de matriz. El índice se basa en 0.

Ejemplos

Ruta	Descripción
.store.book[0].author	El autor del primer libro.
.store.book[-1].author	El autor del último libro.
.address.city	Nombre de la ciudad.
["store"]["book"][0]["title"]	El título del primer libro.
["store"]["book"][-1]["title"]	El título del último libro.

nota

Todo el contenido de Goessner citado en esta documentación está sujeto a la Licencia de Creative Commons.

Prefijos comunes de errores

Cada mensaje de error tiene un prefijo. A continuación se muestra una lista de prefijos comunes de errores.

Prefix	Descripción
ERR	Un error general.
LIMIT	Un error que se produce cuando se excede el límite de tamaño. Por ejemplo, cuando se excede el límite de tamaño del documento o el límite de profundidad de anidación.
NONEXISTENT	Una clave o ruta no existe.
OUTOFBOUNDARIES	Un índice de matrices fuera de los límites.
SYNTAXERR	Error de sintaxis.
WRONGTYPE	Tipo de valor incorrecto.

JSONMétricas relacionadas

Se proporcionan las siguientes métricas de JSON información:

Información	Descripción
json_total_memory_bytes	Memoria total asignada a JSON los objetos.
json_num_documents	Número total de documentos en Valkey o OSS Redis.

Para consultar las métricas principales, ejecute el siguiente comando:

info json_core_metrics

Cómo ElastiCache interactúan Valkey y Redis OSS con JSON

En la siguiente sección se describe cómo OSS interactúan Valkey y Redis ElastiCache con el tipo de datos. JSON

Jerarquía de los operadores

Al evaluar las expresiones condicionales para el filtrado, las &&s tienen prioridad y, a continuación, se evalúan las ||s, como es común en la mayoría de los idiomas. Las operaciones entre paréntesis se ejecutan primero.

Comportamiento del límite máximo de anidación

El límite máximo de anidación de rutas en ElastiCache (OSSRedis) es 128. Así que un valor como $.a.b.c.d... solo puede alcanzar 128 niveles.

Administración de valores numéricos

JSONno tiene tipos de datos separados para números enteros y números de punto flotante. Todos se llaman números.

Representaciones numéricas:

Cuando se recibe un JSON número en la entrada, se convierte en una de las dos representaciones binarias internas: un entero con signo de 64 bits o un punto flotante de IEEE doble precisión de 64 bits. No se retiene la cadena original ni nada de su formato. Por lo tanto, cuando se genera un número como parte de una JSON respuesta, se convierte de la representación binaria interna a una cadena imprimible que utiliza reglas de formato genéricas. Estas reglas podrían dan como resultado que se genere una cadena diferente de la que se recibió.

Comandos aritméticos NUMINCRBY y NUMMULTBY:

• Si ambos números son enteros y el resultado está fuera del rango deint64, se convierte automáticamente en un número de coma flotante de IEEE doble precisión de 64 bits.

• Si al menos uno de los números es un punto flotante, el resultado es un número de coma flotante de IEEE doble precisión de 64 bits.

• Si el resultado supera el intervalo de 64 bits IEEE dobles, el comando devuelve un OVERFLOW error.

Para obtener una lista de los comandos disponibles, consulte el Comandos Valkey y OSS Redis compatibles.

Filtrado de matrices directas

ElastiCache con Valkey o Redis OSS filtra directamente los objetos de la matriz.

Para datos como [0,1,2,3,4,5,6] una consulta de ruta$[?(@<4)], o datos como {"my_key":[0,1,2,3,4,5,6]} y una consulta de ruta como$.my_key[?(@<4)], ElastiCache con Valkey o Redis se OSS obtendría [1,2,3] en ambas circunstancias.

Comportamiento de indexación de matrices

ElastiCache con Valkey o Redis OSS permite índices positivos y negativos para las matrices. Para una matriz de longitud cinco, 0 consultaría el primer elemento, 1 el segundo y, así, sucesivamente. Los números negativos comienzan al final de la matriz, por lo que -1 consultaría el quinto elemento, -2 el cuarto elemento, y así sucesivamente.

Para garantizar un comportamiento predecible para los clientes, ElastiCache con Valkey o Redis OSS no se redondean los índices de matriz hacia abajo o hacia arriba, por lo que si tiene una matriz con una longitud de 5, llamar al índice 5 o superior, o -6 o inferior, no producirá ningún resultado.

Evaluación de sintaxis estricta

MemoryDB no permite JSON rutas con una sintaxis no válida, incluso si un subconjunto de la ruta contiene una ruta válida. Esto es para mantener un comportamiento correcto para nuestros clientes.