AttributesToCSV 2025.5.31.15

번들

org.apache.nifi | nifi-standard-nar

설명

입력 FlowFile 특성의 CSV 표현을 생성합니다. 결과 CSV 는 새로 생성된 ‘CSVAttributes’라는 특성에 쓰거나 FlowFile 에 내용으로 작성할 수 있습니다. 특성 값에 쉼표, 개행 또는 큰따옴표가 포함된 경우 특성 값은 큰따옴표로 이스케이프 처리됩니다. 특성 값의 큰따옴표 문자는 다른 큰따옴표로 이스케이프 처리됩니다.

태그

attributes, csv, flowfile

입력 요구 사항

REQUIRED

민감한 동적 속성 지원

false

속성

속성

설명

특성 목록

결과 CSV 에 포함할 특성을 쉼표로 구분한 목록입니다. 이 값을 비워두면 기존의 모든 특성이 포함됩니다. 이 특성 목록은 대/소문자를 구분하며 쉼표가 포함된 특성 이름을 지원합니다. 목록에 지정된 특성을 찾을 수 없는 경우 ‘Null Value’ 속성에 따라 빈 문자열 또는 null이 포함된 결과 CSV 로 전송됩니다. 이 목록에 Core 특성이 지정되어 있고 ‘Include Core Attributes’ 속성이 false인 경우 해당 Core 특성이 포함됩니다. 특성 목록 ALWAYS 가 우선순위를 갖습니다.

attributes-regex

플로우 파일 특성에 대해 평가하여 일치하는 특성을 선택할 정규식입니다. 이 속성은 Attribute List 속성과 함께 사용할 수 있습니다. 최종 출력에는 ATTRIBUTE_LIST 및 ATTRIBUTE_REGEX 에서 찾은 일치 항목의 조합이 포함됩니다.

대상

CSV 값을 새 flowfile 특성 ‘CSVData’로 쓸지, 아니면 flowfile 내용에 쓸지 제어합니다.

include-core-attributes

모든 FlowFile 에 포함된 FlowFile org.apache.nifi.flowfile.attributes.CoreAttributes 를 생성된 최종 CSV 값에 포함할지 여부를 결정합니다. Core 특성은 CSVData 및 CSVSchema 문자열 끝에 추가됩니다. Attribute List 속성은 이 설정을 재정의합니다.

include-schema

true이면 스키마(특성 이름)도 CSV 문자열로 변환되어 ‘CSVSchema’ 라는 새 특성에 적용되거나 DESTINATION 속성 설정에 따라 내용의 첫 번째 행에 적용됩니다.

null-value

true이면 존재하지 않거나 비어 있는 특성은 결과 CSV 에서 ‘null’이 됩니다. false이면 빈 문자열이 CSV 에 배치됩니다.

관계

이름

설명

실패

특성을 CSV 로 변환하지 못함

성공

특성이 CSV 로 변환됨

Writes 특성

이름

설명

CSVSchema

스키마의 CSV 표현

CSVData

특성의 CSV 표현