Tous les produits
Search
Centre de documentation

MaxCompute:JSON_EXTRACT

Dernière mise à jour :Sep 17, 2026

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é a d'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.