SQLite
 sql >> Database >  >> RDS >> SQLite

Funzioni e operatori JSON in SQLite (elenco completo)

Di seguito è riportato un elenco completo delle funzioni JSON e degli operatori JSON disponibili in SQLite.

Funzioni scalari

Funzione Descrizione
json() Restituisce una versione ridotta del relativo argomento (stringa JSON) come JSON effettivo. Fondamentalmente, converte il testo non elaborato che assomiglia a JSON in JSON reale.
json_array() Restituisce un array JSON ben formato in base ai suoi argomenti.
json_array_length() Restituisce il numero di elementi in un dato array JSON.
json_extract() Estrae e restituisce uno o più valori da JSON ben formati.
json_insert() Inserisce un nuovo valore in un documento JSON.
json_object() Restituisce un oggetto JSON ben formato in base ai suoi argomenti.
json_patch() Aggiunge, modifica e/o elimina elementi di un oggetto JSON (esegue l'algoritmo MergePatch RFC-7396 per applicare una determinata patch all'input JSON specificato).
json_remove() Rimuove uno o più elementi da un oggetto o una matrice JSON.
json_replace() Sostituisce un valore esistente in un documento JSON con un altro valore.
json_set() Inserisce o sostituisce un valore in un documento JSON.
json_type() Restituisce il tipo dell'elemento più esterno del JSON specificato.
json_valid() Verifica se il suo argomento è JSON ben formato.
json_quote() Converte un numero o una stringa nella corrispondente rappresentazione JSON.

Funzioni aggregate

Funzione Descrizione
json_group_array() Restituisce una matrice JSON composta da tutti i valori nell'aggregazione.
json_group_object() Restituisce un oggetto JSON composto da tutte le coppie nome/valore nell'aggregazione.

Funzioni con valori di tabella

Funzione Descrizione
json_each() Esamina il valore JSON fornito come primo argomento e restituisce una tabella composta da una riga per ogni elemento dell'array o membro dell'oggetto. Percorre solo i figli immediati dell'array o dell'oggetto di livello superiore, o solo l'elemento di livello superiore stesso se l'elemento di livello superiore è un valore primitivo.
json_tree() Esamina il valore JSON fornito come primo argomento e restituisce una tabella composta da una riga per ogni elemento dell'array o membro dell'oggetto. Percorre ricorsivamente la sottostruttura JSON a partire dall'elemento di livello superiore.

Operatori JSON

SQLite include anche i seguenti operatori per lavorare con JSON:

Operatore Descrizione
-> Estrae un sottocomponente da un documento JSON e restituisce una rappresentazione JSON di quel sottocomponente.
->> Estrae un sottocomponente da un documento JSON e restituisce una rappresentazione SQL di quel sottocomponente.

Supporto JSON in SQLite

A partire da SQLite 3.38.0 (rilasciato il 22 febbraio 2022), le funzioni e gli operatori JSON sono integrati in SQLite. Prima di SQLite 3.38.0, dovresti usare -DSQLITE_ENABLE_JSON1 opzione in fase di compilazione per abilitare il supporto JSON.