EvaluateJsonPath 2025.5.31.15¶
捆绑包¶
org.apache.nifi | nifi-standard-nar
描述¶
对照 FlowFile 的内容评估一个或多个 JsonPath 表达式。这些表达式的结果将分配给 FlowFile 属性或写入 FlowFile 本身的内容，具体取决于处理器的配置。JsonPaths 通过添加用户定义的属性来输入；属性的名称映射到要放置结果的属性名称（如果目标为“flowfile-attribute”；否则，属性名称将被忽略）。该属性的值必须是有效的 JsonPath 表达式。“auto-detect”的返回类型将根据配置的目的地进行确定。当“目标”设置为“flowfile-attribute”时，将使用“scalar”的返回类型。当“目标”设置为“flowfile-content”时，将使用“JSON”的返回类型。如果 JsonPath 评估为 JSON 数组或 JSON 对象，且返回类型设置为“scalar”，则 FlowFile 不会被修改且会路由至“failure”。如果提供的 JsonPath 评估为指定值，则 JSON 的返回类型可以返回标量值，并将作为匹配项路由。如果“目标”为 “flowfile-content”，且 JsonPath 的值不符合定义的路径，则 FlowFile 将被路由到“unmatched”且其内容不会被修改。如果目标为“flowfile-attribute”且表达式不匹配任何内容，则除非将“路径未找到行为”设置为“跳过”，否则将使用空字符串作为值创建属性，且 FlowFile 将始终路由到“matched”。
输入要求¶
REQUIRED
支持敏感的动态属性¶
false
属性¶
属性 |
描述 |
|---|---|
目标 |
表示 JsonPath 评估结果是写入 FlowFile 内容还是写入 FlowFile 属性；如果使用属性，则必须指定“属性名称”属性。如果设置为 flowfile-content，则只能指定一个 JsonPath 且属性名称将被忽略。 |
最大字符串长度 |
解析 JSON 文档时字符串值的最大允许长度 |
Null 值表示形式 |
表示生成 null 值的 JSON 路径表达式的所需表示形式。 |
路径未找到行为 |
表示在目标设置为“flowfile-attribute”时如何处理缺失的 JSON 路径表达式。当找不到 JSON 路径表达式时，选择“warn”将生成警告。选择“skip”将省略任何不匹配 JSON 路径表达式的属性。 |
返回类型 |
指示 JSON 路径表达式的所需返回类型。 选择“auto-detect”会将“flowfile-content”的目标返回类型设置为“json”，将“flowfile-attribute”的目标返回类型设置为“scalar”。 |
关系¶
名称 |
描述 |
|---|---|
failure |
当 JsonPath 无法根据 FlowFile 的内容进行评估时，FlowFiles 将路由到此关系；例如，如果 FlowFile 非有效 JSON |
matched |
成功评估 JsonPath 且 FlowFile 因此被修改后，FlowFiles 将路由到此关系 |
unmatched |
当 JsonPath 与 FlowFile 的内容不匹配且目标设置为“flowfile-content”时，FlowFiles 将路由到此关系 |