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