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.