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.

JSONDescripción general de los tipos de datos

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

Terminología

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. La cantidad de memoria que consume un JSON documento se puede inspeccionar mediante el JSON.DEBUG MEMORY comando.

JSON ACLs

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 interior «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 clave de OSS Valkey o Redis 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

JSONpara Valkey y Redis OSS admite dos tipos de sintaxis de rutas:

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

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:

JSONmétricas relacionadas

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

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

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

Cuando se recibe un JSON número, se almacena en uno de los 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. Operaciones aritméticas con dos JSON números (p. ej. JSON NUMINCRBYy. JSON NUMMULTBY) intentan preservar 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 IEEE doble precisión 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 de la admitidos.

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.