Extrait des données d'une valeur JSON en fonction du paramètre json_path spécifié.
Syntaxe
JSON JSON_EXTRACT(JSON <json_expr>, STRING <json_path>)
-- Standard example.
-- Returns 1.
SELECT JSON_EXTRACT(JSON '{"a":1, "b":2}', '$.a');
Paramètres
json_expr : Obligatoire. La valeur JSON à traiter.
json_path : Obligatoire. Une valeur de type STRING qui spécifie le chemin d'accès à la valeur que vous souhaitez renvoyer.
Valeur renvoyée
Renvoie une valeur JSON. Les règles suivantes s'appliquent :
Si le paramètre json_path n'est pas valide, la fonction renvoie NULL.
Si le paramètre json_path est mal formé, la fonction renvoie une erreur.
Exemples
-
Exemple 1 : Extraire la valeur de la clé
ad'un objet JSON.SELECT JSON_EXTRACT(JSON '{"a":1, "b":2}', '$.a');Le résultat suivant est renvoyé :
+-----+ | _c0 | +-----+ | 1 | +-----+ -
Exemple 2 : Si le chemin JSON spécifié n'est pas valide ou si la clé de destination n'existe pas, la fonction renvoie NULL.
SELECT JSON_EXTRACT(JSON '{"a":1, "b":2}', '$.c');Le résultat suivant est renvoyé :
+-----+ | _c0 | +-----+ | NULL | +-----+ -
Exemple 3 : Si le format du chemin JSON est incorrect, la fonction renvoie un message d'erreur.
SELECT JSON_EXTRACT(JSON '{"a":1, "b":2}', '$a');Le résultat suivant est renvoyé :
Invalid argument - Param json path $invalid_json_path is invalid
Fonctions associées
JSON_EXTRACT est une fonction JSON. Pour plus d'informations sur les autres fonctions JSON, consultez la rubrique Fonctions JSON.