EvaluateXPath 프로세서
EvaluateXPath 프로세서
Snowflake Openflow의 EvaluateXPath 프로세서에 대한 문서예요. FlowFile의 콘텐츠에 대해 하나 이상의 XPath를 평가하는 프로세서예요.
출처: Snowflake 문서
본문
기능 — 일반 제공(Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP 상용(Commercial) 리전의 모든 계정에서 사용할 수 있어요. Openflow BYOC 배포는 AWS 상용(Commercial) 리전의 모든 계정에서 사용할 수 있어요.
번들(Bundle)
org.apache.nifi | nifi-standard-nar
설명(Description)
FlowFile의 콘텐츠에 대해 하나 이상의 XPath를 평가해요. 그 XPath의 결과는 프로세서 구성에 따라 FlowFile 속성에 할당되거나 FlowFile 콘텐츠 자체에 기록돼요. XPath는 사용자 정의 속성을 추가해 입력하며, 속성 이름은 결과가 배치될 Attribute Name에 매핑돼요(Destination이 flowfile-attribute인 경우. 그렇지 않으면 속성 이름은 무시돼요). 속성 값은 유효한 XPath 표현식이어야 해요. XPath가 둘 이상의 노드로 평가되는데 Return Type이 'nodeset'이면(직접 또는 'auto-detect'와 Destination 'flowfile-content'를 통해) FlowFile은 변경되지 않고 failure로 라우팅돼요. XPath가 노드로 평가되지 않으면 FlowFile은 콘텐츠를 변경하지 않은 채 'unmatched'로 라우팅돼요. Destination이 flowfile-attribute이고 표현식이 아무것도 일치하지 않으면 값이 빈 문자열인 속성이 만들어지며 FlowFile은 항상 'matched'로 라우팅돼요.
태그(Tags)
XML, XPath, evaluate
입력 요구사항(Input Requirement)
REQUIRED
민감 동적 속성 지원(Supports Sensitive Dynamic Properties)
false
속성(Properties)
| 속성(Property) | 설명(Description) |
|---|---|
| Destination | XPath 평가 결과를 FlowFile 콘텐츠에 기록할지 FlowFile 속성에 기록할지 나타내요. 속성을 사용하려면 Attribute Name 속성을 지정해야 해요. flowfile-content로 설정하면 XPath를 하나만 지정할 수 있고 속성 이름은 무시돼요. |
| Return Type | XPath 표현식의 원하는 반환 유형을 나타내요. 'auto-detect'를 선택하면 Destination이 'flowfile-content'일 때 'nodeset', 'flowfile-attribute'일 때 'string'으로 반환 유형을 설정해요. |
| Validate DTD | XML에 임베디드 Document Type Declaration을 허용해요. XML 엔티티 확장 취약점을 피하려면 이 기능을 비활성화해야 해요. |
관계(Relationships)
| 이름(Name) | 설명(Description) |
|---|---|
| failure | FlowFile의 콘텐츠에 대해 XPath를 평가할 수 없을 때 FlowFile은 이 관계로 라우팅돼요. 예를 들어 FlowFile이 유효한 XML이 아니거나, Return Type이 'nodeset'인데 XPath가 여러 노드로 평가되는 경우예요. |
| matched | XPath가 성공적으로 평가되고 그 결과 FlowFile이 수정되면 FlowFile은 이 관계로 라우팅돼요. |
| unmatched | XPath가 FlowFile의 콘텐츠와 일치하지 않고 Destination이 flowfile-content로 설정되어 있으면 FlowFile은 이 관계로 라우팅돼요. |
속성 기록(Writes attributes)
| 이름(Name) | 설명(Description) |
|---|---|
| user-defined | 이 프로세서는 |