Dans MySQL, le JSON_ARRAY_INSERT() La fonction est utilisée pour insérer une nouvelle valeur dans un tableau.
Vous fournissez le document JSON comme premier argument, suivi du chemin d'accès dans lequel insérer, suivi de la valeur à insérer.
Syntaxe
La syntaxe ressemble à ceci :
JSON_INSERT(json_doc, path, val[, path, val] ...)
Où :
json_docest le document JSON.pathest le chemin de l'élément pour lequel insérer la nouvelle valeur.valest la nouvelle valeur qui sera insérée.
Les paires chemin-valeur sont évaluées de gauche à droite. Le document produit en évaluant une paire devient la nouvelle valeur par rapport à laquelle la paire suivante est évaluée.
Exemple 1 - Utilisation de base
Voici un exemple pour illustrer.
SELECT JSON_ARRAY_INSERT('[1, 2, 3]', '$[1]', 4) AS 'Result';
Résultat :
+--------------+ | Result | +--------------+ | [1, 4, 2, 3] | +--------------+
Ainsi, le 3ème argument est inséré dans le tableau au chemin spécifié. Dans ce cas, j'utilise $[1] pour le chemin, qui fait référence au deuxième élément (les tableaux JSON utilisent une numérotation à partir de zéro - la numérotation commence à 0 ).
Exemple 2 – Tableau imbriqué
Voici un exemple d'insertion d'une valeur dans un tableau imbriqué dans un autre tableau.
SELECT JSON_ARRAY_INSERT('[1, 2, [3, 4]]', '$[2][1]', 5) AS 'Result';
Résultat :
+-------------------+ | Result | +-------------------+ | [1, 2, [3, 5, 4]] | +-------------------+
Donc ici, j'utilise $[2][1] comme chemin. Le [2] fait référence au 3ème élément du tableau externe. Le [1] fait référence au 2ème élément du tableau imbriqué.
Exemple 3 – Un document JSON plus volumineux
Cet exemple utilise un document JSON (légèrement) plus grand. Cela montre comment le chemin change en fonction de l'emplacement du tableau dans le document.
SET @data = '{
"Person": {
"Name": "Homer",
"Hobbies": ["Eating", "Sleeping"]
}
}';
SELECT JSON_ARRAY_INSERT(@data, '$.Person.Hobbies[1]', "Base Jumping") AS 'Result';
Résultat :
+----------------------------------------------------------------------------------+
| Result |
+----------------------------------------------------------------------------------+
| {"Person": {"Name": "Homer", "Hobbies": ["Eating", "Base Jumping", "Sleeping"]}} |
+----------------------------------------------------------------------------------+