JSON解析

1 概述

1.1 版本

1.2 应用场景

通过数据库或API读取数据时，存在取到的数据包含 JSON 格式数据的情况。而且，JSON 格式的数据大多并不标准，不能直接映射成二维表数据使用。
那么，就可以使用【JSON解析】组件解析 JSON 结构的数据，最终输出行列格式的数据。

1.3业务场景

• 通过与写入API对接，采用轻量化的JSON格式实现高效数据交换。例如，在企业用户管理场景中，用户管理系统通过API获取JSON格式的原始数据后，将其转换为行列式结构化数据，便于直接写入数仓或下游分析系统，支撑实时查询与批量计算需求。

1.4 功能简介

【JSON解析】是通过获取上游输出的JSON数据或任务参数中的JSON数据，将其自定义解析成需要的字段并输出给下游。

2 功能说明

JSON解析组件配置，主要包括：JSON解析和数据预览。

2.1 JSON解析

“JSON解析”的配置如下：

主要包含数据来源、源字段或参数、解析后是否保留所有上游输出字段、解析JSON数据的配置。具体说明如下：

2.1.1 数据来源

JSON解析数据来源支持两种：上游节点、参数。
上游节点：待解析的JSON数据来源于上游节点中的某些输出字段，选择该类型时，需要选择对应的上游节点字段，支持多选；

参数：待解析的JSON数据来源于当前任务参数，选择该类型时，需要选择对应的任务参数，支持多选。

注：下拉选项中仅显示文本类型的源字段（或参数）。

2.1.2 解析后保留所有上游输出字段

JSON解析最终输出字段是否包含上游节点中的输出字段。
未勾选时，解析后的结果：只保留所选源字段解析后的字段数据，不包含所有上游节点的源字段数据。或者是仅显示所选参数解析后的字段数据，不包含上游节点的所有输出字段。
勾选时，解析后的结果：上游节点的所有输出字段加上解析后的字段数据。

2.1.3 解析JSON数据

点击“选择JSON节点”，进入选择窗口，如下图：

左侧显示所有的所选带解析源字段（或参数），右侧自动显示对应源字段（或参数）的第一行JSON数据，以第一行数据结构为标准进行解析。
JSON节点结构允许自定义，可以更改获取的原始JSON结构。
如果原始JSON结构有变更，则点击“重新获取”可将JSON结构进行重置获取最新的JSON结构。

可按需选择JSON数据结构中需要输出的字段，配置完成后确定，所选择的节点将显示在下方的列表中，显示对应源字段解析后的字段，并按照JSON层级结构自动生成每个字段的解析路径（完整绝对路径），默认从根节点开始，格式为：$一级节点名称.二级节点名称.当前节点名称，如果某节点是数组，节点显示为“节点名称[*]”。

解析字段名称和解析路径均允许更改，但不能为空；也支持手动添加字段或删除字段。

注：
1、参数的JSON数据结构，如果该参数未被改变，则显示该任务参数中配置的参数值；若当前JSON解析前参数通过“参数赋值”组件为该参数设置了调试值，则显示的是该任务参数最新的调试值。
2、复杂JSON结构可使用多个「JSON解析」组件解析「嵌套JSON」数据。

2.2 数据预览

JSON解析配置完成后，将按照配置输出对应的字段，通过JSON解析后的字段将根据对应解析路径解析出对应字段的全部数据，多条数据将进行扩展成多行进行显示。

若JSON解析后的字段对应解析路径存在空值，将无法进行数据预览；若根据解析路径解析不到对应数据，则会显示空。