CompressContent 2025.5.31.15¶

捆绑包¶

org.apache.nifi | nifi-standard-nar

描述¶

使用用户指定的压缩算法对 FlowFiles 的内容进行压缩或解压，并相应地更新 mime.type 属性。常见的使用方式是在 CompressContent 前添加 IdentifyMimeType，并将其配置为：Mode='decompress' AND Compression Format='use mime.type attribute'。以这种方式使用时，系统会自动检测 MIME 类型，并在必要时对数据进行解压。如果无需解压，则数据将传递到“success”关系。该处理器在内存方面效率很高，因此即使处理对象远超堆内存大小，通常也不会有问题。

标签¶

brotli、bzip2、compress、content、decompress、deflate、gzip、lz4-framed、lzma、snappy、snappy framed、snappy-hadoop、xz-lzma2、zstd

输入要求¶

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，在解压时会移除文件扩展名（仅当扩展名表示适当的压缩格式时），在压缩时则会添加相应扩展名。

关系¶

名称	描述
failure	如果 FlowFiles 压缩或解压失败，将被传送到 failure 关系
success	FlowFiles 成功压缩或解压缩后将传送到 success 关系

写入属性¶

名称	描述
mime.type	如果将 Mode 属性设置为 compress，则会设置相应的 MIME 类型。如果将 Mode 属性设置为 decompress 并且文件成功解压缩，则会移除该属性，因为已无法确定 MIME 类型。

用例¶

压缩 FlowFile 的内容

解压缩 FlowFile 的内容

涉及其他组件的用例¶

检查 FlowFile 是否已压缩，如果是，则将其解压缩。