Información general del tipo de datos JSON

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

MemoryDB admite una serie de comandos de Valkey y Redis OSS para trabajar con el tipo de datos JSON. A continuación se presenta información general del tipo de datos JSON y una lista detallada de los comandos compatibles.

Terminología

Estándares JSON admitidos

El formato JSON es compatible con el estándar de intercambio de datos JSON RFC 7159 y ECMA-404. Se admite UTF-8 Unicode en texto JSON.

Elemento raíz

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

Límite de tamaño del documento

Los documentos JSON se almacenan de manera interna en un formato que se optimiza para lograr un acceso y 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 solo documento JSON está limitado a 64 MB, que es el tamaño de la estructura de datos en memoria, no la cadena JSON. La cantidad de memoria que consume un documento JSON puede examinarse mediante el uso del comando JSON.DEBUG MEMORY.

JSON ACLs

Límite de profundidad de anidado

Cuando un objeto o matriz JSON tiene un elemento que es otro objeto o matriz JSON, se dice que ese objeto o matriz interior se “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 de Valkey o Redis OSS como primer argumento. Algunos comandos también tienen un argumento ruta. El argumento de ruta se establece de manera predeterminada en la raíz si es opcional y no se proporciona.

Notación:

Sintaxis de ruta

JSON para Valkey y Redis OSS admite dos tipos de sintaxis de ruta:

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

Sintaxis mejorada

Ejemplos

Los siguientes ejemplos se basan en los datos XML del ejemplo de Goessner, que hemos modificado agregando matrices 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
    }
  }
}

Más ejemplos de expresiones de filtro:

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

Ejemplos

Prefijos comunes de errores

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

Métricas relacionadas con JSON

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

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

info json_core_metrics

Cómo interactúa MemoryDB con JSON

A continuación, se ilustra cómo interactúa MemoryDB 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 ejecutarán primero.

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

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

Administración de valores numéricos

JSON no tiene tipos de datos separados para números enteros y de coma flotante. Todos se llaman números.

Cuando se recibe un número JSON, se puede almacenar en dos formatos. Si el número cabe en un entero con signo de 64 bits, se convierte a ese formato; de lo contrario, se almacena como una cadena. Las operaciones aritméticas en dos números JSON (por ejemplo, JSON.NUMINCRBY y JSON.NUMMULTBY) intentan conservar la mayor precisión posible. Si los dos operandos y el valor resultante caben en un entero con signo de 64 bits, se realiza la aritmética de enteros. De lo contrario, los operandos de entrada se convierten en números de coma flotante de doble precisión según el IEEE de 64 bits, se realiza la operación aritmética y el resultado se convierte de nuevo en una cadena.

Comandos aritméticos NUMINCRBY y NUMMULTBY:

Para obtener una lista de los comandos disponibles, consulte el Comandos admitidos.

Evaluación de sintaxis estricta

MemoryDB no permite rutas JSON con 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.