根据JSON字符串jsonStrschema信息,返回ARRAY、MAP或STRUCT类型。

命令格式

from_json(<jsonStr>, <schema>)

参数说明

  • jsonStr:必填。输入的JSON字符串。
  • schema:必填。写法与建表语句的类型一致。例如array<bigint>map<string, array<string>>struct<a:int, b:double, `C`:map<string,string>>
    说明 STRUCT的Key区分大小写。此外,STRUCT类型还有一种写法a bigint, b double,等同于struct<a:bigint, b:double>

    JSON数据类型与MaxCompute数据类型的对应关系如下。

    JSON数据类型MaxCompute数据类型
    OBJECTSTRUCT、MAP、STRING
    ARRAYARRAY、STRING
    NUMBERTINYINT、SMALLINT、INT、BIGINT、FLOAT、DOUBLE、DECIMAL、STRING
    BOOLEANBOOLEAN、STRING
    STRINGSTRING、CHAR、VARCHAR、BINARY、DATE、DATETIME
    NULL所有类型
    说明 对于OBJECT和ARRAY类型,会采用尽可能解析的方式,不匹配的类型会忽略。为了便于使用,所有的JSON类型都可以转换为MaxCompute的STRING类型。同时您需要注意,对应FLOAT、DOUBLE、DECIMAL三种数据类型无法保证小数的精度,如果需要确保精度可以先用STRING类型取出数据,再转换为对应数值类型。

返回值说明

返回ARRAY、MAP或STRUCT类型。

FROM_JSON

  • 示例1:将指定JSON字符串以指定格式输出。命令示例如下。
    --返回{"a":1,"b":0.8}。
    select from_json('{"a":1, "b":0.8}', 'a int, b double');
    
    --返回{"time":"26/08/2015"}。
    select from_json('{"time":"26/08/2015"}', 'time string');
    
    --返回{"a":1,"b":0.8}。
    select from_json('{"a":1, "b":0.8}', 'a int, b double, c string');
    
    --返回[1,2,3]。
    select from_json('[1, 2, 3, "a"]', 'array<bigint>');
    
    --返回{"d":"v","a":"1","b":"[1,2,3]","c":"{}"}。
    select from_json('{"a":1,"b":[1,2,3],"c":{},"d":"v"}', 'map<string, string>');
  • 示例2:使用map_keys函数和from_json函数实现类似JSON_KEYS的作用,获取JSON字符串中所有key的集合。命令示例如下。
    --返回["a","b"]。
    select map_keys(from_json('{"a":1,"b":2}','map<string,string>'));