ReplaceText 2025.5.31.15¶
バンドル¶
org.apache.nifi | nifi-standard-nar
説明¶
FlowFile 内のテキスト値を (正規表現/正規表現、またはリテラル値で) 検索し、マッチした部分を代替値で置き換えることで、 FlowFile のコンテンツを更新します。また、 FlowFile のコンテンツにテキストを追加または前置するためにも使用できます。
入力要件¶
REQUIRED
機密動的プロパティをサポート¶
false
プロパティ¶
プロパティ |
説明 |
---|---|
文字セット |
ファイルがエンコードされている文字セット |
評価モード |
「置換ストラテジー」を各行に対して個別に実行するか(行単位)、ファイル全体をメモリにバッファリングして(テキスト全体)、それに対して実行します。 |
Line-by-Line評価モード |
最初の行(ヘッダー)のみ、最後の行(フッター)のみ、最初の行(ヘッダー)を除く、または最後の行(フッター)を除く FlowFile のすべての行に対して、各行に対して個別に(行ごとに)「置換ストラテジー」を実行します。 |
最大バッファサイズ |
置換を適用するためにバッファリングするデータの最大量(評価モードに応じて、ファイルごとまたは行ごと)を指定します。「テキスト全体」(評価モード)が選択され、 FlowFile がこの値より大きい場合、 FlowFile は「失敗」にルーティングされます。「Line-by-Line」モードでは、1つのLineがこの値より大きい場合、 FlowFile は、「失敗」にルーティングされます。デフォルト値の1 MB は、主に「Entire Text(テキスト全体)」モード用で提供されます。「ライン・バイ・ライン」モードでは、8 KB や 16 KB といった値が推奨されます。<Replacement Strategy> プロパティが以下のいずれかにセットされている場合、この値は無視されます:Append, Prepend, Always Replace |
正規表現 |
FlowFile コンテンツで検索する検索値。「リテラル置換」と「正規表現置換」のマッチングストラテジーでのみ使用されます。 |
置換ストラテジー |
FlowFile のテキストコンテンツ内で、何をどのように置き換えるかというストラテジー。 |
置換値 |
「置換戦略」を使用して挿入する値。正規表現によるキャプチャグループの後方参照はサポートされていますが、正規表現に存在しないキャプチャグループを参照する後方参照はリテラル値として扱われます。後方参照は、式言語を使用して、'$1'、'$2'などのように参照することもできます。これらの変数は「Standard」属性名ではないため、 MUST には、シングルチックマークが含まれます(属性名は、数字、アルファベット、_のみを含む場合を除き、引用符で囲む必要があります)。 |
追加するテキスト |
評価モードプロパティの構成値に応じて、 FlowFile の末尾に追加するテキスト、または各行に追加するテキスト。 |
プリペンドするテキスト |
評価モードプロパティの構成値に応じて、 FlowFile、または各行の先頭に付加するテキスト。 |
リレーションシップ¶
名前 |
説明 |
---|---|
failure |
更新できなかった FlowFiles は、このリレーションシップにルーティングされます。 |
success |
正常に処理された FlowFiles は、このリレーションシップにルーティングされます。これには、テキストが差し替えられたものとそうでない FlowFiles の両方が含まれます。 |
ユースケース¶
FlowFile の各行の末尾にテキストを追加します。 |
FlowFile の各行の先頭にテキストを追加します。 |
FlowFile にリテラル文字列が出現するたびに異なる値に置き換えます。 |
FlowFile のリテラル文字列を変換します。 |
FlowFile のコンテンツを特定のテキストに完全に置き換えます。 |