ExecuteStreamCommand 2025.5.31.15¶

Bundle¶

org.apache.nifi | nifi-standard-nar

Beschreibung¶

Der ExecuteStreamCommand-Prozessor bietet eine flexible Möglichkeit, externe Befehle und Skripte in NiFi-Datenflüsse zu integrieren. ExecuteStreamCommand kann den Inhalt des eingehenden FlowFile an den Befehl weiterleiten, den es ausführt, ähnlich wie bei einer Pipe.

Tags¶

command, command execution, execute, stream

Eingabeanforderung¶

REQUIRED

Unterstützt sensible dynamische Eigenschaften¶

true

Eigenschaften¶

Eigenschaft	Beschreibung
Argument Delimiter	Trennzeichen zum Trennen von Argumenten für einen Befehl [Standard: ;]. Muss ein einzelnes Zeichen sein
Command Arguments	Die Argumente, die der ausführbaren Datei übergeben werden sollen, begrenzt durch das Zeichen „;“.
Command Path	Gibt den auszuführenden Befehl an. Wenn nur der Name einer ausführbaren Datei angegeben wird, muss sich diese im Umgebungs-PATH des Benutzers befinden.
Ignore STDIN	Bei „true“ wird der Inhalt des eingehenden FlowFile nicht an den ausführenden Befehl weitergegeben.
Max Attribute Length	Wenn Sie die Ausgabe des Stream-Befehls an ein Attribut weiterleiten, wird maximal diese Anzahl von Zeichen an den Attributwert angehängt. Dies ist wichtig, da Attribute im Speicher gehalten werden und große Attribute schnell zu Problemen führen, wenn der Speicher voll ist. Wenn die Ausgabe diesen Wert überschreitet, wird sie entsprechend gekürzt. Erwägen Sie, dies zu verkleinern, sofern möglich.
Output Destination Attribute	Wenn diese Option gesetzt ist, wird die Ausgabe des Stream-Befehls in ein Attribut des ursprünglichen FlowFile anstatt in ein separates FlowFile geschrieben. Es gibt keinen Beziehung mehr für „output stream“ oder „nonzero status“. Der Wert dieser Eigenschaft ist der Schlüssel für das Ausgabeattribut.
Output MIME Type	Gibt den Wert an, der für das Attribut „mime.type“ gesetzt werden soll. Diese Eigenschaft wird ignoriert, wenn „Output Destination Attribute“ gesetzt ist.
Working Directory	Das Verzeichnis, das beim Ausführen des Befehls als aktuelles Arbeitsverzeichnis verwendet wird
argumentsStrategy	Strategie für die Konfiguration der Argumente, die dem Befehl übergeben werden sollen.

Einschränkungen¶

Erforderliche Berechtigung	Erläuterung
execute code	Bietet dem Operator die Möglichkeit, beliebigen Code unter Verwendung aller Berechtigungen von NiFi auszuführen.

Beziehungen¶

Name	Beschreibung
nonzero status	Der Zielpfad für das FlowFile, das aus der Ausgabe des Befehls erstellt wurde, wenn der zurückgegebene Statuscode ungleich Null ist. Alle FlowFiles, die an diese Beziehung weitergeleitet werden, werden zurückgestellt.
original	Das Original-FlowFile wird weitergeleitet. Es wird neue Attribute enthalten, die das Ergebnis der Skriptausführung detailliert beschreiben.
output stream	Der Zielpfad für das FlowFile, das aus der Ausgabe des Befehls erstellt wurde, wenn der zurückgegebene Statuscode Null ist.

Schreibt Attribute¶

Name	Beschreibung
execution.command	Der Name des ausgeführten Befehls
execution.command.args	Die durch Semikolon getrennte Liste der Argumente. Sensible Eigenschaften werden maskiert
execution.status	Der Exit-Statuscode, der nach Ausführung des Befehls zurückgegeben wird
execution.error	Alle Fehlermeldungen, die bei der Ausführung des Befehls zurückgegeben werden
mime.type	Legt den MIME-Typ der Ausgabe fest, wenn die Eigenschaft „Output MIME Type“ gesetzt ist und „Output Destination Attribute“ nicht gesetzt ist.