CompressContent 2025.5.31.15¶
번들¶
org.apache.nifi | nifi-standard-nar
설명¶
사용자가 지정한 압축 알고리즘을 사용하여 FlowFiles 의 내용을 압축 또는 압축 해제하고 mime.type 특성을 적절히 업데이트합니다. 일반적인 관용구는 CompressContent 앞에 IdentifyMimeType 을 붙이고 모드=’decompress’ 및 압축 형식=’use mime.type attribute’로 구성하는 것입니다. 이 방식으로 사용하면 MIME 타입이 자동으로 감지되고 필요한 경우 데이터 압축이 해제됩니다. 압축 해제가 불필요한 경우, 데이터는 ‘성공’ 관계로 전달됩니다. 이 프로세서는 메모리 효율이 매우 높은 방식으로 작업하므로 일반적으로 힙 크기를 훨씬 초과하는 매우 큰 오브젝트도 처리할 수 있습니다.
입력 요구 사항¶
REQUIRED
민감한 동적 속성 지원¶
false
속성¶
속성 |
설명 |
---|---|
압축 형식 |
사용할 압축 형식입니다. 유효한 값: GZIP, Deflate, ZSTD, BZIP2, XZ-LZMA2, LZMA, Brotli, Snappy, Snappy Hadoop, Snappy Framed 및 LZ4-Framed |
압축 수준 |
사용할 압축 수준으로, gzip, deflate 또는 xz-lzma2 압축을 사용할 때만 유효합니다. 값이 낮을수록 처리 속도는 빨라지지만 압축은 줄어들며, 값이 0이면 gzip의 경우 없음(즉, 단순 보관), xz-lzma2 압축의 경우 최소값을 나타냅니다. 레벨이 높을수록 메모리 사용량이 훨씬 커질 수 있으므로(예: xz-lzma/2의 경우 레벨 7~9) 힙 크기와 관련하여 주의해야 합니다. |
모드 |
프로세서가 내용을 압축할지 압축 해제할지 여부를 나타냅니다. ‘compress’ 또는 ‘decompress’여야 합니다 |
파일 이름 업데이트 |
true이면, 데이터를 압축 해제할 때 파일 이름 확장자를 제거하고(확장자가 적절한 압축 형식을 나타내는 경우에만) 데이터를 압축할 때 적절한 확장자를 추가합니다 |
관계¶
이름 |
설명 |
---|---|
실패 |
FlowFiles 은 압축/압축 해제에 실패하면 실패 관계로 이전됩니다 |
성공 |
FlowFiles 은 압축 또는 압축 해제에 성공한 후 성공 관계로 전송됩니다 |
Writes 특성¶
이름 |
설명 |
---|---|
mime.type |
모드 속성이 압축으로 설정되어 있으면 적절한 MIME 유형이 설정됩니다. 모드 속성이 압축 해제로 설정되어 있고 파일이 성공적으로 압축 해제된 경우 MIME 유형이 더 이상 알려지지 않으므로 이 특성이 제거됩니다. |
사용 사례¶
FlowFile 의 내용 압축 |
FlowFile 의 내용을 압축 해제 |
다른 구성 요소가 포함된 사용 사례¶
FlowFile 이 압축되어 있는지 확인하고 압축되어 있다면 압축을 해제합니다. |