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 은 항상 ‘일치’로 라우팅됩니다

태그

JSON, JsonPath, 평가

입력 요구 사항

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 은 이 관계로 라우팅됩니다.