parseJsonTable

语法

parseJsonTable(json, [schema], [keyCaseSensitive=true])

参数

json 包含 JSON 对象的字符串标量或向量。当 json 是字符串标量时,可以包含1个或多个 JSON 对象。暂不支持 JSON 数组和递归 JSON 对象。

schema 可选参数,表对象,用于指定各字段的数据类型。它可以包含以下列(必须包含 name 和 type 列):

列名

含义

name 字符串,表示列名
type 字符串,表示各列的数据类型。暂不支持 BLOB 类型。
format 字符串,表示数据文件中日期或时间列的格式
如果不指定 schema,则函数将前10个 JSON 对象,自动解析表结构。

keyCaseSensitive 可选参数,表示 key 的名称是否大小写敏感。true(默认值)表示大小写敏感,false 表示大小写不敏感。

详情

将 JSON 对象解析为内存表。
  • json 是包含多个 JSON 对象的字符串时,每个对象都将转换为表的一行数据;例如,{"ID":10, "NAME":"Riquelme","Club":"Boca Juniors"}
  • json 是字符串向量时,向量中每个 json 元素转换为表的一行数据。例如,[json1, json2, json3]。
  • 当以上两种条件中的 json 包含空值时,即 {},在转换后的表中,该空值所在行的位置相应留空。

例子

json1='{"ID":1, "NAME":"cc"}{"NAME":"dd"}'
parseJsonTable(json1)

返回:

ID NAME
1 cc
dd
json2 = '{"col_test":"20190522150407"}'
schemaTB = table(["col_test"] as name, ["DATETIME"] as type, ["yyyyMMddHHmmss"] as format)
parseJsonTable(json2, schemaTB)

返回:

col_test
2019.05.22T15:04:07

json 是包含两个 JSON 对象的字符串时:

json3='{"ID":11, "NAME":"dd"}'
schemaTB1 = table(["ID", "NAME", "col_test"] as name, ["INT", "STRING", "DATETIME"] as type, [,,"yyyyMMddHHmmss"] as format)
parseJsonTable(concat([json2,json3]),schemaTB1)

返回:

ID NAME col_test
2019.05.22T15:04:07
11 dd

json 是字符串向量时:

parseJsonTable([json2,json3],schemaTB1)

返回:

ID NAME col_test
2019.05.22T15:04:07
11 dd

下例中定义了一个有三行数据的 json 对象 home,第三行数据为空({})。在第四行中,parseJsonTable 按照第三行中 schemaLiga 中定义的 schema 转换为名为 formation 的内存表。

home = ['{"Num":10, "Name":"Ronaldo","Goal":"3","MatchDay":"20120322"}','{"Num":3, "Name":"Carlos","Goal":"1","MatchDay":"20120322"}','{}'];
schemaLiga = table(["Num","Name","Goal","MatchDay"] as name, ["INT","STRING","INT","DATE"] as type, [,,,"yyyyMMdd"] as format);
formation = parseJsonTable(home,schemaLiga);
formation;

返回:

Num Name Goal MatchDay
10 Ronaldo 3 2012.03.22
3 Carlos 1 2012.03.22

打印结果显示,原属于 json 对象 home 的第三行显示为空。