ExtractText 2025.10.2.19¶

バンドル¶

org.apache.nifi | nifi-standard-nar

説明¶

FlowFile の内容に対して、1つ以上の正規表現を評価します。これらの正規表現の結果は、FlowFile 属性に割り当てられます。正規表現は、ユーザー定義のプロパティを追加することによって入力されます。プロパティの名前は、結果が配置される属性名に対応します。属性は、名前付きキャプチャグループを有効にすることに基づいて、異なる形で生成されます。名前付きキャプチャグループが有効になっていない場合、次のようになります。最初のキャプチャグループが見つかれば、その属性名に配置されます。しかし、一致する文字列シーケンスそのものを含むすべてのキャプチャグループは、オプションであり一致しなかったキャプチャグループを除いて、インデックス値が提供されたその属性名でも提供されます。たとえば、属性名「regex」と式「abc(def)?(g)」が与えられた場合、「def」が一致すれば、「def」という値を持つ属性「regex.1」を追加することになります。「def」が一致しなかった場合、「regex.1」という名前の属性は追加されませんが、「g」という値を持つ「regex.2」という名前の属性は関係なく追加されます。名前付きキャプチャグループが有効になっている場合、次のようになります。それぞれの名前の付いたキャプチャグループが見つかれば、指定された名前で属性名に配置されます。有効になっている場合、一致する文字列シーケンスそのものが属性名に配置されます。複数の一致が有効な場合、インデックスは最初の一連の一致の後に適用されます。例外として、オプションでありながら一致しないキャプチャグループが挙げられます。たとえば、属性名「regex」と式「abc(?<NAMED>def)?(?<NAMED-TWO>g)」が与えられた場合、「def」が一致すれば、「def」という値を持つ属性「regex. NAMED」を追加することになります。一致するかどうかにかかわらず、「g」が一致した場合は、「regex. NAMED-TWO」という属性に「g」という値を追加します。プロパティの値は、1つ以上のキャプチャグループを持つ有効な正規表現でなければなりません。名前付きキャプチャグループが有効な場合は、すべてのキャプチャグループに名前を付ける必要があります。そうでない場合、プロセッサー構成の検証は失敗します。正規表現が複数回一致した場合、キャプチャグループの繰り返しを有効にするプロパティがtrueに設定されていない限り、最初に一致したものだけが使用されます。指定された正規表現が一致した場合、FlowFile は「matched」にルーティングされます。指定された正規表現が一致しない場合、FlowFile は「unmatched」にルーティングされ、FlowFile に属性は適用されません。

タグ¶

正規表現, テキスト, 評価, 抽出, regex

入力要件¶

REQUIRED

機密動的プロパティをサポート¶

false

プロパティ¶

リレーションシップ¶