Vous trouverez ci-dessous une liste complète des fonctions JSON et des opérateurs JSON disponibles dans SQLite.
Fonctions scalaires
Fonction | Description |
json() | Renvoie une version réduite de son argument (chaîne JSON) en tant que JSON réel. Fondamentalement, il convertit le texte brut qui ressemble à JSON en JSON réel. |
json_array() | Renvoie un tableau JSON bien formé en fonction de ses arguments. |
json_array_length() | Renvoie le nombre d'éléments dans un tableau JSON donné. |
json_extract() | Extrait et renvoie une ou plusieurs valeurs d'un JSON bien formé. |
json_insert() | Insère une nouvelle valeur dans un document JSON. |
json_object() | Renvoie un objet JSON bien formé en fonction de ses arguments. |
json_patch() | Ajoute, modifie et/ou supprime des éléments d'un objet JSON (il exécute l'algorithme RFC-7396 MergePatch pour appliquer un correctif donné à l'entrée JSON donnée). |
json_remove() | Supprime un ou plusieurs éléments d'un objet ou d'un tableau JSON. |
json_replace() | Remplace une valeur existante dans un document JSON par une autre valeur. |
json_set() | Insère ou remplace une valeur dans un document JSON. |
json_type() | Renvoie le type de l'élément le plus externe du JSON donné. |
json_valid() | Vérifie si oui ou non son argument est bien formé JSON. |
json_quote() | Convertit un nombre ou une chaîne dans sa représentation JSON correspondante. |
Fonctions d'agrégation
Fonction | Description |
json_group_array() | Renvoie un tableau JSON composé de toutes les valeurs de l'agrégation. |
json_group_object() | Renvoie un objet JSON composé de toutes les paires nom/valeur de l'agrégation. |
Fonctions de table
Fonction | Description |
json_each() | parcourt la valeur JSON fournie comme premier argument et renvoie un tableau composé d'une ligne pour chaque élément de tableau ou membre d'objet. Il parcourt uniquement les enfants immédiats du tableau ou de l'objet de niveau supérieur, ou uniquement l'élément de niveau supérieur lui-même si l'élément de niveau supérieur est une valeur primitive. |
json_tree() | parcourt la valeur JSON fournie comme premier argument et renvoie un tableau composé d'une ligne pour chaque élément de tableau ou membre d'objet. Il parcourt de manière récursive la sous-structure JSON en commençant par l'élément de niveau supérieur. |
Opérateurs JSON
SQLite inclut également les opérateurs suivants pour travailler avec JSON :
Opérateur | Description |
-> | Extrait un sous-composant d'un document JSON et renvoie une représentation JSON de ce sous-composant. |
->> | Extrait un sous-composant d'un document JSON et renvoie une représentation SQL de ce sous-composant. |
Prise en charge de JSON dans SQLite
À partir de SQLite 3.38.0 (publié le 22 février 2022), les fonctions et opérateurs JSON sont intégrés à SQLite. Avant SQLite 3.38.0, vous deviez utiliser le -DSQLITE_ENABLE_JSON1
option de compilation pour activer la prise en charge de JSON.