ReplaceText 2025.5.31.15¶

捆绑包¶

org.apache.nifi | nifi-standard-nar

描述¶

通过在 FlowFile 内容中搜索某些文本值（通过正则表达式/regex 或字面量值）并将内容中匹配的部分替换为某个替代值来更新 FlowFile 的内容。它还可用于在 FlowFile 的内容中追加或前置文本。

标签¶

Change、Modify、Regex、Regular Expression、Replace、Text、Update

输入要求¶

REQUIRED

支持敏感的动态属性¶

false

属性¶

属性	描述
字符集	对文件进行编码的字符集
评估模式	分别对每行运行“替换策略”（逐行）或将整个文件缓冲到内存（整个文本）中，然后对其运行。
逐行评估模式	分别对 FlowFile 中的每行运行“替换策略”（逐行），仅第一行（标头）、仅最后一行（页脚）、除第一行（标头）以外的所有行或除最后一行（页脚）以外的所有行。
最大缓冲区大小	指定要缓冲的最大数据量（每个文件或每行，取决于评估模式），以便应用替换。如果选择了“整个文本”（在评估模式下），并且 FlowFile 大于此值，则 FlowFile 会被路由到“failure”。在“逐行”模式下，如果单行大于此值，则 FlowFile 会被路由到“failure”。提供的默认值为 1 MB，主要用于“整个文本”模式。在“逐行”模式下，建议使用诸如 8 KB 或 16 KB 之类的值。如果将 <Replacement Strategy> 属性设置为以下值之一，则忽略此值：Append、Prepend、Always Replace
正则表达式	要在 FlowFile 内容中搜索的搜索值。仅用于“字面量替换”和“正则表达式替换”匹配策略
替换策略	在 FlowFile 的文本内容中如何替换以及替换什么内容的策略。
替换值	使用“替换策略”插入的值。支持对正则表达式捕获组使用“正则表达式替换”反向引用，但是引用正则表达式中不存在的捕获组的反向引用将被视为字面量值。也可以使用表达式语言引用反向引用，如“$1”、“$2”等。MUST 包括单勾号，因为这些变量不是“标准”属性名称（除非属性名称仅包含数字、字母和 _，否则必须加引号）。
要追加的文本	要追加到 FlowFile 末尾或每行的文本，具体取决于“评估模式”属性的配置值
要前置的文本	要前置到 FlowFile 开头或每行的文本，具体取决于“评估模式”属性的配置值

关系¶

名称	描述
failure	无法更新的 FlowFiles 将路由到此关系
success	已成功处理的 FlowFiles 将路由到此关系。这包括已替换文本和未替换的文本的 FlowFiles。

用例¶

将文本追加到 FlowFile 中每行的末尾

将文本前置到 FlowFile 中每行的开头

将 FlowFile 中每次出现的字面量字符串替换为不同的值

转换 FlowFile 中每次出现的字面量字符串

将 FlowFile 的内容完全替换为特定文本