Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

JSONpanoramica dei tipi di dati

ElastiCache supporta una serie di OSS comandi Valkey e Redis per lavorare con il tipo di JSON dati. Di seguito è riportata una panoramica del tipo di JSON dati e un elenco dettagliato dei comandi supportati.

Terminology

JSONStandard supportato

JSONil formato è conforme agli standard di interscambio RFCdati 7159 e ECMA-404JSON. UTF-8 È supportato il formato Unicode nel testo. JSON

Elemento radice

L'elemento radice può essere di qualsiasi tipo di JSON dati. Si noti che nella versione precedente del RFC 4627, solo gli oggetti o gli array erano consentiti come valori radice. Dall'aggiornamento alla versione RFC 7159, la radice di un JSON documento può essere di qualsiasi tipo JSON di dati.

Limite delle dimensioni del documento

JSONi documenti vengono archiviati internamente in un formato ottimizzato per un accesso e una modifica rapidi. Questo formato generalmente comporta un consumo di memoria lievemente superiore alla rappresentazione serializzata equivalente dello stesso documento.

Il consumo di memoria da parte di un singolo JSON documento è limitato a 64 MB, che è la dimensione della struttura dei dati in memoria, non della JSON stringa. È possibile controllare la quantità di memoria consumata da un JSON documento utilizzando il JSON.DEBUG MEMORY comando.

JSON ACLs

Limite di profondità di nidificazione

Quando un JSON oggetto o un array ha un elemento che è a sua volta un altro JSON oggetto o array, si dice che quell'oggetto o array interno «nidifica» all'interno dell'oggetto o dell'array esterno. Il limite massimo di profondità di nidificazione è 128. Qualunque tentativo di creare un documento che contenga una profondità di nidificazione maggiore di 128 verrà rifiutato con un errore.

Sintassi dei comandi

La maggior parte dei comandi richiede un nome chiave come primo argomento. Alcuni comandi hanno anche un argomento path. L'argomento path per impostazione predefinita è la radice se è facoltativo e non viene fornito.

Notazione:

Sintassi del percorso

Redis JSON supporta due tipi di sintassi dei percorsi:

Se un percorso di interrogazione inizia con '$', utilizza la sintassi avanzata. In caso contrario, viene utilizzata la sintassi limitata.

Sintassi avanzata

Examples (Esempi)

I seguenti esempi sono basati sui XML dati di esempio di Goessner, che abbiamo modificato aggiungendo campi aggiuntivi.

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

Altri esempi di espressioni 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]"

Sintassi limitata

Examples (Esempi)

Prefissi di errori comuni

Ogni messaggio di errore ha un prefisso. Di seguito è riportato un elenco di prefissi di errori comuni..

JSON-metriche correlate

Vengono fornite le seguenti metriche JSON informative:

Per interrogare le metriche principali, esegui il seguente comando:

info json_core_metrics

Come ElastiCache interagisce con Valkey e Redis OSS JSON

La sezione seguente descrive come ElastiCache con Valkey e Redis OSS interagisce con il tipo di dati. JSON

Precedenza degli operatori

Durante la valutazione delle espressioni condizionali per il filtro, && hanno la precedenza, quindi vengono valutati ||, come nella maggior parte dei linguaggi. Operazioni tra parentesi vengono eseguite per prime.

Comportamento del limite massimo di nidificazione dei percorsi

Il limite massimo di annidamento dei percorsi in ElastiCache (RedisOSS) è 128. Per cui, un valore come $.a.b.c.d... può raggiungere solo 128 livelli.

Gestione dei valori numerici

JSONnon ha tipi di dati separati per numeri interi e numeri in virgola mobile. Sono tutti definiti “numeri”.

Rappresentazioni numeriche:

Quando un JSON numero viene ricevuto in input, viene convertito in una delle due rappresentazioni binarie interne: un intero con segno a 64 bit o una virgola mobile a IEEE doppia precisione a 64 bit. La stringa originaria e tutta la formattazione non vengono mantenute. Pertanto, quando un numero viene emesso come parte di una JSON risposta, viene convertito dalla rappresentazione binaria interna in una stringa stampabile che utilizza regole di formattazione generiche. Queste regole potrebbero determinare la generazione di una stringa diversa da quella ricevuta.

Comandi aritmetici NUMINCRBY e NUMMULTBY:

Per un elenco dei comandi disponibili, consulta Comandi Valkey e Redis OSS supportati.

Filtraggio array diretto

ElastiCache con Valkey o Redis OSS filtra direttamente gli oggetti dell'array.

Per dati come [0,1,2,3,4,5,6] e una query di percorso come$[?(@<4)], o dati simili {"my_key":[0,1,2,3,4,5,6]} e una query di percorso come$.my_key[?(@<4)], ElastiCache con Valkey o Redis OSS restituirebbe [1,2,3] in entrambe le circostanze.

Comportamento di indicizzazione array

ElastiCache con Valkey o Redis OSS consente indici positivi e negativi per gli array. Per un array di lunghezza cinque, 0 interroga il primo elemento, 1 il secondo e così via. I numeri negativi iniziano alla fine dell'array, per cui -1 interroga il quinto elemento, -2 il quarto e così via.

Per garantire un comportamento prevedibile per i clienti, ElastiCache con Valkey o Redis OSS non arrotonda gli indici degli array verso il basso o verso l'alto, quindi se si dispone di un array con una lunghezza di 5, chiamare l'indice 5 o superiore, oppure -6 o inferiore, non produrrebbe alcun risultato.

Valutazione della sintassi rigida

MemoryDB non consente JSON percorsi con sintassi non valida, anche se un sottoinsieme del percorso contiene un percorso valido. Ciò permantenere un comportamento corretto per i nostri clienti.