EvaluateJsonPath 2025.10.2.19¶
번들¶
org.apache.nifi | nifi-standard-nar
설명¶
Evaluates one or more JsonPath expressions against the content of a FlowFile. The results of those expressions are assigned to FlowFile Attributes or are written to the content of the FlowFile itself, depending on configuration of the Processor. JsonPaths are entered by adding user-defined properties; the name of the property maps to the Attribute Name into which the result will be placed (if the Destination is flowfile-attribute; otherwise, the property name is ignored). The value of the property must be a valid JsonPath expression. A Return Type of ‘auto-detect’ will make a determination based off the configured destination. When ‘Destination’ is set to ‘flowfile-attribute,’ a return type of ‘scalar’ will be used. When ‘Destination’ is set to ‘flowfile-content,’ a return type of ‘JSON’ will be used. If the JsonPath evaluates to a JSON array or JSON object and the Return Type is set to ‘scalar’ the FlowFile will be unmodified and will be routed to failure. A Return Type of JSON can return scalar values if the provided JsonPath evaluates to the specified value and will be routed as a match. If Destination is ‘flowfile-content’ and the JsonPath does not evaluate to a defined path, the FlowFile will be routed to ‘unmatched’ without having its contents modified. If Destination is ‘flowfile-attribute’ and the expression matches nothing, attributes will be created with empty strings as the value unless ‘Path Not Found Behaviour’ is set to ‘skip’, and the FlowFile will always be routed to ‘matched.’
입력 요구 사항¶
REQUIRED
민감한 동적 속성 지원¶
false
속성¶
속성 |
설명 |
|---|---|
Destination |
JsonPath 평가의 결과를 FlowFile 내용에 기록할지, FlowFile 특성에 기록할지를 나타내며, 특성을 사용하는 경우 속성 이름 속성을 지정해야 합니다. flowfile 내용으로 설정된 경우 1개의 JsonPath 만 지정할 수 있으며 속성 이름은 무시됩니다. |
Max String Length |
JSON 문서를 구문 분석할 때 허용되는 문자열 값의 최대 길이입니다 |
Null Value Representation |
Null 값을 반환하는 JSON 경로 식의 원하는 표현을 나타냅니다. |
Path Not Found Behavior |
대상이 ‘flowfile-attribute’으로 설정된 경우 누락된 JSON 경로 식을 처리하는 방법을 나타냅니다. ‘warn’을 선택하면 JSON 경로 식을 찾을 수 없을 때 경고가 생성됩니다. ‘skip’을 선택하면 일치하지 않는 JSON 경로 식에 대한 특성이 생략됩니다. |
Return Type |
Indicates the desired return type of the JSON Path expressions. Selecting ‘auto-detect’ will set the return type to ‘json’ for a Destination of ‘flowfile-content’, and ‘scalar’ for a Destination of ‘flowfile-attribute’. |
관계¶
이름 |
설명 |
|---|---|
실패 |
FlowFiles 은 FlowFile 의 내용에 대해 JsonPath 를 평가할 수 없는 경우(예: FlowFile 이 유효하지 않은 JSON 인 경우) 이 관계로 라우팅됩니다. |
matched |
FlowFiles 은 JsonPath 가 성공적으로 평가되고 FlowFile 이 수정되면 이 관계로 라우팅됩니다 |
unmatched |
JsonPath 가 FlowFile 의 내용과 일치하지 않고 대상이 flowfile-content로 설정된 경우 FlowFiles 은 이 관계로 라우팅됩니다. |