EvaluateXQuery 프로세서

EvaluateXQuery 프로세서

Snowflake Openflow의 EvaluateXQuery 프로세서에 대한 문서예요. FlowFile의 콘텐츠에 대해 하나 이상의 XQuery를 평가하는 프로세서예요.

출처: Snowflake 문서

본문

기능 — 일반 제공(Generally Available)

Openflow Snowflake 배포는 AWS, Azure, GCP 상용(Commercial) 리전의 모든 계정에서 사용할 수 있어요. Openflow BYOC 배포는 AWS 상용(Commercial) 리전의 모든 계정에서 사용할 수 있어요.

번들(Bundle)

org.apache.nifi | nifi-standard-nar

설명(Description)

FlowFile의 콘텐츠에 대해 하나 이상의 XQuery를 평가해요. 그 XQuery의 결과는 프로세서 구성에 따라 FlowFile 속성에 할당되거나 FlowFile 콘텐츠 자체에 기록돼요. XQuery는 사용자 정의 속성을 추가해 입력하며, 속성 이름은 결과가 배치될 Attribute Name에 매핑돼요(Destination이 'flowfile-attribute'인 경우. 그렇지 않으면 속성 이름은 무시돼요). 속성 값은 유효한 XQuery여야 해요. XQuery가 둘 이상의 결과를 반환하면 각 결과에 대해 새 속성 또는 FlowFile(Destination이 각각 'flowfile-attribute' 또는 'flowfile-content'인 경우)을 만들어요(속성에는 지정된 속성 이름 뒤에 '.n' 일련 번호가 붙어요). 제공된 XQuery 중 하나라도 결과를 반환하면 FlowFile은 'matched'로 라우팅돼요. 제공된 XQuery 중 어떤 것도 결과를 반환하지 않으면 FlowFile은 'unmatched'로 라우팅돼요. Destination이 'flowfile-attribute'이고 XQuery가 아무것도 일치하지 않으면 FlowFile에 속성이 적용되지 않아요.

태그(Tags)

XML, XPath, XQuery, evaluate

입력 요구사항(Input Requirement)

REQUIRED

민감 동적 속성 지원(Supports Sensitive Dynamic Properties)

false

속성(Properties)

속성(Property) 설명(Description)
Destination XQuery 평가 결과를 FlowFile 콘텐츠에 기록할지 FlowFile 속성에 기록할지 나타내요. 로 설정하면 XQuery를 하나만 지정할 수 있고 속성 이름은 무시돼요. 로 설정하고 XQuery가 둘 이상의 결과를 반환하면 FlowFile에 여러 속성이 추가되며, 각 속성은 지정된 속성 이름 뒤에 '.n' 일련 번호가 붙어요.
Output: Indent 결과 트리를 출력할 때 프로세서가 추가 공백을 넣을 수 있는지 지정해요.
Output: Method 결과 트리를 출력하는 데 사용할 전체적인 방법을 식별해요.
Output: Omit XML Declaration 결과 트리를 변환할 때 프로세서가 XML 선언을 출력할지 여부를 지정해요.
Validate DTD XML에 임베디드 Document Type Declaration을 허용해요. XML 엔티티 확장 취약점을 피하려면 이 기능을 비활성화해야 해요.

관계(Relationships)

이름(Name) 설명(Description)
failure FlowFile의 콘텐츠에 대해 XQuery를 평가할 수 없을 때 FlowFile은 이 관계로 라우팅돼요.
matched XQuery가 성공적으로 평가되고 그 결과 FlowFile이 수정되면 FlowFile은 이 관계로 라우팅돼요.
unmatched XQuery가 FlowFile의 콘텐츠와 일치하지 않고 Destination이 flowfile-content로 설정되어 있으면 FlowFile은 이 관계로 라우팅돼요.

속성 기록(Writes attributes)

이름(Name) 설명(Description)
user-defined 이 프로세서는 속성이 flowfile-attribute로 설정되면 사용자 정의 속성을 추가해요.

더 알아보기 (Learn more)