ExecuteStreamCommand 2025.5.31.15¶

Bundle¶

org.apache.nifi | nifi-standard-nar

Description¶

Le processeur ExecuteStreamCommand offre un moyen souple d’intégrer des commandes et des scripts externes dans les flux de données de NiFi. ExecuteStreamCommand peut transmettre le contenu du FlowFile à la commande qu’il exécute, de la même manière que pour le piping.

Balises¶

command, command execution, execute, stream

Exigences en matière d’entrées¶

REQUIRED

Prend en charge les propriétés dynamiques sensibles¶

true

Propriétés¶

Propriété	Description
Délimiteur d’argument	Délimiteur à utiliser pour séparer les arguments d’une commande [default : ;]. Doit être un seul caractère
Arguments de commande	Les arguments à fournir à l’exécutable délimités par le caractère « ; ».
Chemin de commande	Spécifie la commande à exécuter ; si seul le nom d’un exécutable est fourni, il doit se trouver dans le PATH de l’environnement de l’utilisateur.
Ignorer STDIN	Si c’est le cas, le contenu du fichier de flux entrant ne sera pas transmis à la commande en cours d’exécution
Longueur maximale de l’attribut	Si vous routez la sortie de la commande de flux vers un attribut, le nombre de caractères mis dans la valeur de l’attribut sera au maximum de cette quantité. Ceci est important car les attributs sont conservés en mémoire et les attributs de grande taille entraîneront rapidement des problèmes de saturation de la mémoire. Si la sortie est plus longue que cette valeur, elle sera tronquée. Envisagez de le réduire si possible.
Attribut de la destination de sortie	Si ce paramètre est défini, la sortie de la commande de flux sera placée dans un attribut du FlowFile original au lieu d’un FlowFile séparé. Il n’y aura plus de relation pour « flux de sortie » ou « statut non nul ». La valeur de cette propriété sera la clé de l’attribut de sortie.
Type de sortie MIME	Spécifie la valeur à fixer pour l’attribut mime.type. Cette propriété est ignorée si l’attribut de destination de la sortie est paramétré.
Répertoire de travail	Le répertoire à utiliser comme répertoire de travail courant lors de l’exécution de la commande
argumentsStrategy	Stratégie de configuration des arguments à fournir à la commande.

Restrictions¶

Autorisation requise	Explication
exécuter le code	Fournit à l’opérateur la possibilité d’exécuter un code arbitraire en bénéficiant de toutes les autorisations dont dispose NiFi.

Relations¶

Nom	Description
nonzero status	Le chemin de destination du fichier de flux créé à partir de la sortie de la commande, si le code de statut renvoyé est différent de zéro. Tous les fichiers de flux routés vers cette relation seront pénalisés.
original	Le FlowFile original sera routé. Il aura de nouveaux attributs détaillant le résultat de l’exécution du script.
flux de sortie	Le chemin de destination du FlowFile créé à partir de la sortie de la commande, si le code de statut renvoyé est zéro.

Écrit les attributs¶

Nom	Description
execution.command	Le nom de la commande exécutée
execution.command.args	La liste des arguments délimitée par des points-virgules. Les propriétés sensibles seront masquées
execution.status	Le code de statut de sortie renvoyé après l’exécution de la commande
execution.error	Tous les messages d’erreur renvoyés lors de l’exécution de la commande
mime.type	Définit le type MIME de la sortie si la propriété « Output MIME Type » est définie et si « Output Destination Attribute » n’est pas défini