EvaluateJsonPath 2025.5.31.15¶
번들¶
org.apache.nifi | nifi-standard-nar
설명¶
FlowFile 의 내용에 대해 1개 이상의 JsonPath 식을 평가합니다. 이러한 식의 결과는 프로세서의 구성에 따라 FlowFile 특성에 할당되거나 FlowFile 자체의 내용에 기록됩니다. JsonPaths 는 사용자 정의 속성을 추가하여 입력되며, 속성 이름은 결과가 배치될 특성 이름에 매핑됩니다(대상이 flowfile 속성인 경우, 그렇지 않으면 속성 이름이 무시됨). 속성 값은 유효한 JsonPath 식이어야 합니다. 반환 유형이 ‘auto-detect’인 경우 구성된 대상을 기반으로 결정합니다. ‘Destination’을 ‘flowfile-attribute’로 설정하면 반환 유형이 ‘스칼라’로 사용됩니다. ‘Destination’이 ‘flowfile-content’로 설정된 경우 반환 타입이 ‘JSON’이 사용되며, JsonPath 가 JSON 배열 또는 JSON 오브젝트로 평가되고 반환 타입이 ‘스칼라’로 설정된 경우 FlowFile 은 수정되지 않고 실패로 라우팅됩니다. 반환 유형이 JSON 인 경우 제공된 JsonPath 가 지정된 값으로 평가되어 일치하는 것으로 라우팅되는 경우 스칼라 값을 반환할 수 있으며, 대상이 ‘flowfile-content’이고 JsonPath 가 지정된 경로로 평가되지 않는 경우 FlowFile 은 내용을 수정하지 않고 ‘unmatched’로 라우팅됩니다. 대상이 ‘flowfile-attribute’이고 식이 일치하는 항목이 없는 경우 ‘경로를 찾을 수 없음 동작’이 ‘skip’으로 설정되어 있지 않으면 빈 문자열을 값으로 사용하여 특성이 생성되며 FlowFile 은 항상 ‘일치’로 라우팅됩니다
입력 요구 사항¶
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 |
JSON 경로 식의 원하는 반환 유형을 나타냅니다. ‘auto-detect’를 선택하면 반환 유형이 ‘flowfile-content’ 대상의 경우 ‘json’으로, ‘flowfile-attribute’ 대상의 경우 ‘스칼라’로 설정됩니다. |
관계¶
이름 |
설명 |
---|---|
실패 |
FlowFiles 은 FlowFile 의 내용에 대해 JsonPath 를 평가할 수 없는 경우(예: FlowFile 이 유효하지 않은 JSON 인 경우) 이 관계로 라우팅됩니다. |
matched |
FlowFiles 은 JsonPath 가 성공적으로 평가되고 FlowFile 이 수정되면 이 관계로 라우팅됩니다 |
unmatched |
JsonPath 가 FlowFile 의 내용과 일치하지 않고 대상이 flowfile-content로 설정된 경우 FlowFiles 은 이 관계로 라우팅됩니다. |