UnpackContent 프로세서
UnpackContent 프로세서
Openflow의 UnpackContent 프로세서는 TAR, ZIP, FlowFile Stream 형식으로 패키징된 내용을 푸는 데 사용합니다. 이 문서에서 프로세서의 번들, 설명, 속성, 관계 등을 확인할 수 있습니다.
출처: Snowflake 문서
본문
번들 (Bundle)
org.apache.nifi | nifi-standard-nar
설명 (Description)
여러 패키징 형식 중 하나로 패키징된 FlowFile의 내용을 풀어서, 입력 FlowFile 하나당 하나 이상의 FlowFile을 생성합니다. 지원되는 형식은 TAR, ZIP, FlowFile Stream 패키지입니다.
태그 (Tags)
Unpack, archive, flowfile-stream, flowfile-stream-v3, tar, un-merge, zip
입력 요구사항 (Input Requirement)
REQUIRED
민감한 동적 속성 지원 (Supports Sensitive Dynamic Properties)
false
속성 (Properties)
| 속성 (Property) | 설명 (Description) |
|---|---|
| File Filter | 아카이브에 들어 있는 파일 중 이름이 주어진 정규 표현식과 일치하는 파일만 추출됩니다(tar/zip만 해당). |
| Filename Character Set | 지정하면 이 문자 집합을 Zip 유틸리티에 전달하여 해당 문자 집합으로 파일 이름을 디코딩하려고 시도합니다. 지정하지 않으면 플랫폼 기본 문자 집합이 사용됩니다. 플랫폼 기본값과 다른 문자 집합으로 Zip을 만들었고 zip이 비표준 값을 사용할 때 유용합니다. |
| Packaging Format | 파일을 만드는 데 사용된 패키징 형식입니다. |
| Password | ZipCrypto 또는 AES로 암호화된 Zip 아카이브를 복호화하는 데 사용하는 암호입니다. 암호를 구성하면 대체 Zip 압축 알고리즘 지원이 비활성화됩니다. |
| allow-stored-entries-wdd | 일부 zip 아카이브에는 사양상 없어야 할 data descriptor가 있는 stored 항목이 포함됩니다. 이 속성이 true이면 그래도 읽습니다. false이고 그런 항목이 발견되면 zip 처리가 실패합니다. |
관계 (Relationships)
| 이름 (Name) | 설명 (Description) |
|---|---|
| failure | 어떤 이유로든 압축을 풀 수 없는 원본 FlowFile이 이 관계로 전송됩니다. |
| original | 성공적으로 압축이 풀린 후 원본 FlowFile이 이 관계로 전송됩니다. |
| success | 압축이 풀린 FlowFile이 이 관계로 전송됩니다. |
기록하는 속성 (Writes attributes)
| 이름 (Name) | 설명 (Description) |
|---|---|
| mime.type | FlowFile이 성공적으로 압축이 풀리면 MIME Type을 더 이상 알 수 없으므로 mime.type 속성이 application/octet-stream으로 설정됩니다. |
| fragment.identifier | 같은 부모 FlowFile에서 생성된 모든 압축 해제 FlowFile에는 무작위로 생성된 동일한 UUID가 이 속성에 추가됩니다. |
| fragment.index | 단일 부모 FlowFile에서 만들어진 압축 해제 FlowFile의 순서를 나타내는 일련 번호입니다. |
| fragment.count | 부모 FlowFile에서 생성된 압축 해제 FlowFile의 수입니다. |
| segment.original.filename | 부모 FlowFile의 파일 이름입니다. MergeContent 프로세서가 원본 FlowFile을 재구성하는 데 사용되면 .tar, .zip, .pkg 확장자를 자동으로 추가하므로 이 확장자들은 제거됩니다. |
| file.lastModifiedTime | 압축 해제된 파일이 마지막으로 수정된 날짜와 시간입니다(tar와 zip만 해당). |
| file.creationTime | 파일이 생성된 날짜와 시간입니다. 암호화된 zip 파일의 경우 이 속성은 항상 file.lastModifiedTime과 같은 값을 가집니다. tar와 암호화되지 않은 zip 파일의 경우 사용 가능하면 반환되고, 그렇지 않으면 file.lastModifiedTime과 같은 값이 됩니다. |
| file.lastMetadataChange | 파일의 메타데이터가 변경된 날짜와 시간입니다(tar만 해당). |
| file.lastAccessTime | 파일이 마지막으로 접근된 날짜와 시간입니다(tar와 암호화되지 않은 zip 파일만 해당). |
| file.owner | 압축 해제된 파일의 소유자입니다(tar만 해당). |
| file.group | 압축 해제된 파일의 그룹 소유자입니다(tar만 해당). |
| file.size | 압축 해제된 파일의 압축 전 크기입니다(tar와 zip만 해당). |
| file.permissions | 압축 해제된 파일의 읽기/쓰기/실행 권한입니다(tar와 암호화되지 않은 zip 파일만 해당). |
| file.encryptionMethod | Zip 아카이브 항목의 암호화 방법입니다. |
사용 사례 (Use cases)
- Windows에서 파일 이름 문자 집합을 Cp437 또는 IBM437로 하여 만든, 특수 문자가 포함된 파일 이름을 가진 Zip 압축 풀기.
함께 보기 (See also)
org.apache.nifi.processors.standard.MergeContent