JSON_LENGTH - MaxCompute - Centre de documentation Alibaba Cloud

La fonction JSON_LENGTH renvoie la longueur des données JSON situées au chemin d'accès spécifié.

Syntaxe

BIGINT JSON_LENGTH(JSON <json> [, STRING <json_path>])

-- 标准示例。
-- 返回2。
SELECT JSON_LENGTH(JSON '{"k1":"v31","k2":300}');

Paramètres

json : obligatoire. Données JSON dont il faut vérifier la longueur. Type JSON.
json_path : facultatif. Chemin d'accès JSON. Type STRING. Si ce paramètre est omis, la fonction renvoie la longueur de l'intégralité des données JSON.

Valeur de retour

La fonction renvoie une valeur de type BIGINT selon les règles suivantes :

Si le paramètre json est un tableau JSON (JSON ARRAY), la valeur renvoyée correspond au nombre d'éléments du tableau.
Si le paramètre json est un objet JSON (JSON OBJECT), la valeur renvoyée correspond au nombre de membres de l'objet.
Si les données du paramètre json sont d'un type autre qu'un tableau ou un objet JSON, la fonction renvoie 1.
Si les paramètres json ou json_path sont null, la fonction renvoie null.
Cette fonction ne tient pas compte de la longueur des tableaux ou objets imbriqués.

Exemples

Exemple 1 : exemple de base.

-- 返回2。
SELECT JSON_LENGTH(JSON '{"k1":"v31","k2":300}');

-- 返回6。
SELECT JSON_LENGTH(JSON '[1,2,3,4,5,6]');

-- 返回3。不考虑嵌套数组或对象的长度。
SELECT 
  JSON_LENGTH(
    JSON '{"name": "John", "age": 22, "skills":["PHP","MySQL","JavaScript"]}'
  );

-- 返回2。
SELECT JSON_LENGTH(JSON '{"x": 1, "y": [1, 2]}', '$.y');

-- 返回null。
SELECT JSON_LENGTH(null);

Exemple 2 : si les données du paramètre json sont d'un type autre qu'un tableau ou un objet JSON, la fonction renvoie 1.

-- 返回1。
SELECT JSON_LENGTH(JSON 'null');

-- 返回1。
SELECT JSON_LENGTH(JSON '123');

-- 返回1。
SELECT JSON_LENGTH(JSON '123.34');

-- 返回1。
SELECT JSON_LENGTH(JSON 'true');

Fonctions associées

La fonction JSON_LENGTH fait partie des fonctions JSON. Pour plus d'informations sur les autres fonctions de type JSON, consultez la rubrique Fonctions JSON.