JSON_TUPLE

命令格式

string json_tuple(string <json>, string <key1>, string <key2>,...)

参数说明

• json：必填。STRING类型，标准的JSON格式字符串。

• key：必填。STRING类型，用于描述在JSON中的path，一次可输入多个，不能以美元符号（$）开头。MaxCompute支持用.或['']这两种字符解析JSON，当JSON的Key本身包含.时，可以用['']来替代。

返回值说明

使用示例

--创建一张表school。
create table school (id string, json string);
--向表中插入数据。
insert into school (id, json) values ("1", "{
\"school\": \"湖畔大学\", \"地址\":\"杭州\", \"SchoolRank\": \"00\", 
\"Class1\":{\"Student\":[{\"studentId\":1,\"scoreRankIn3Year\":[1,2,[3,2,6]]}, 
{\"studentId\":2,\"scoreRankIn3Year\":[2,3,[4,3,1]]}]}}");

• 示例1：提取JSON对象信息。命令示例如下。

  select json_tuple(school.json,"SchoolRank","Class1") as (item0, item1) from school;
  --等效于如下语句。
  select get_json_object(school.json,"$.SchoolRank") item0,get_json_object(school.json,"$.Class1") item1 from school;
  
  --返回结果如下。
  +-------+-------+
  | item0 | item1 |
  +-------+-------+
  | 00    | {"Student":[{"studentId":1,"scoreRankIn3Year":[1,2,[3,2,6]]},{"studentId":2,"scoreRankIn3Year":[2,3,[4,3,1]]}]} |
  +-------+-------+

• 示例2：使用['']提取JSON对象信息。命令示例如下。

  select json_tuple(school.json,"school","['Class1'].Student") as (item0, item2) from school where id=1;
  --返回结果如下。
  +-------+-------+
  | item0 | item2 |
  +-------+-------+
  | 湖畔大学 | [{"studentId":1,"scoreRankIn3Year":[1,2,[3,2,6]]},{"studentId":2,"scoreRankIn3Year":[2,3,[4,3,1]]}] |

• 示例3：支持解析包含中文的JSON数据。命令示例如下。

  select json_tuple(school.json,"school","地址") as (item0,item1) from school;
  --返回结果如下。
  +-------+-------+
  | item0 | item1 |
  +-------+-------+
  | 湖畔大学 | 杭州 |
  +-------+-------+

• 示例4：支持解析多层嵌套的JSON数据。命令示例如下。

  select sc.Id, q.item0, q.item1 
  from school sc lateral view json_tuple(sc.json,"Class1.Student[*].studentId","Class1.Student[0].scoreRankIn3Year") q as item0,item1;
  
  --返回结果如下。
  +------------+-------+-------+
  | id         | item0 | item1 |
  +------------+-------+-------+
  | 1          | [1,2] | [1,2,[3,2,6]] |
  +------------+-------+-------+

• 示例5：支持解析包含多重嵌套数组的JSON数据。命令示例如下。

  select sc.Id, q.item0, q.item1
  from school sc lateral view json_tuple(sc.json,"Class1.Student[0].scoreRankIn3Year[2]","Class1.Student[0].scoreRankIn3Year[2][1]") q as item0,item1;
  --返回结果如下。
  +------------+-------+-------+
  | id         | item0 | item1 |
  +------------+-------+-------+
  | 1          | [3,2,6] | 2     |
  +------------+-------+-------+

相关函数

JSON_TUPLE函数属于复杂类型函数或字符串函数。

• 更多对复杂类型数据（例如ARRAY、MAP、STRUCT、JSON数据）的处理函数请参见复杂类型函数。

• 更多查找字符串、转换字符串格式的相关函数请参见字符串函数。