FetchSFTP 2025.5.31.15¶

Bundle¶

org.apache.nifi | nifi-standard-nar

Description¶

Récupère le contenu d’un fichier sur un serveur SFTP distant et remplace le contenu d’un FlowFile entrant par le contenu du fichier distant.

Balises¶

fetch, files, get, ingest, input, remote, retrieve, sftp, source

Exigences en matière d’entrées¶

REQUIRED

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

false

Propriétés¶

Propriété	Description
Chiffres autorisés	Liste séparée par des virgules des codes autorisés pour les connexions SFTP. Laissez le champ libre pour autoriser tout le monde. Les options disponibles sont : 3des-cbc, 3des-ctr, aes128-cbc, aes128-ctr, aes128-gcm@openssh.com, aes192-cbc, aes192-ctr, aes256-cbc, aes256-ctr, aes256-gcm@openssh.com, arcfour, arcfour128, arcfour256, blowfish-cbc, blowfish-ctr, cast128-cbc, cast128-ctr, chacha20-poly1305@openssh.com, idea-cbc, idea-ctr, serpent128-cbc, serpent128-ctr, serpent192-cbc, serpent192-ctr, serpent256-cbc, serpent256-ctr, twofish-cbc, twofish128-cbc, twofish128-ctr, twofish192-cbc, twofish192-ctr, twofish256-cbc, twofish256-ctr
Stratégie d’achèvement	Indique ce qu’il faut faire du fichier original sur le serveur une fois qu’il a été transféré dans NiFi. Si la stratégie d’achèvement échoue, un avertissement sera connecté mais les données seront tout de même transférées.
Connection Timeout	Délai d’attente avant l’interruption de la création d’une connexion
Créer un répertoire	Utilisé lorsque la stratégie d’achèvement est Déplacer le fichier. Indique si le répertoire distant doit être créé ou non s’il n’existe pas.
Délai d’expiration des données	Lors du transfert d’un fichier entre le système local et le système distant, cette valeur indique le temps qui peut s’écouler sans qu’aucune donnée ne soit transférée entre les systèmes
Disable Directory Listing	Contrôle la façon dont le répertoire de destination du déplacement (« Move Destination Directory ») est créé lorsque la propriété « Completion Strategy » est définie sur « Move File » et que l’option « Create Directory » est activée. Si cette propriété est définie sur « true », le listing des répertoires n’est pas effectué avant la création des répertoires manquants. Par défaut, ce processeur exécute une commande de listing des répertoires pour vérifier l’existence des répertoires cibles avant de créer les répertoires manquants. Toutefois, dans certaines situations, il peut s’avérer nécessaire de désactiver le listing des répertoires, comme dans les cas suivants. Le listing des répertoires peut échouer avec certaines autorisations (par exemple, chmod 100) sur un répertoire. En outre, si un autre client SFTP a créé le répertoire après que ce processeur a effectué un listing et avant qu’une requête de création de répertoire par ce processeur ne soit accomplie, une erreur est renvoyée car le répertoire existe déjà.
Fichier de clé d’hôte	Si fourni, le fichier donné sera utilisé comme clé hôte ; sinon, si la propriété « Strict Host Key Checking » est activée (mise sur true), alors les fichiers « known_hosts » et « known_hosts2 » du répertoire ~/.ssh seront utilisés, sinon aucun fichier de clé hôte ne sera utilisé.
Nom d’hôte	Le nom d’hôte complet ou l’adresse IP de l’hôte à partir duquel les données doivent être extraites
Algorithmes clés autorisés	Liste séparée par des virgules des algorithmes de clé autorisés pour les connexions SFTP. Laissez le champ libre pour autoriser tout le monde. Les options disponibles sont : ecdsa-sha2-nistp256, ecdsa-sha2-nistp256-cert-v01@openssh.com, ecdsa-sha2-nistp384, ecdsa-sha2-nistp384-cert-v01@openssh.com, ecdsa-sha2-nistp521, ecdsa-sha2-nistp521-cert-v01@openssh.com, rsa-sha2-256, rsa-sha2-512, ssh-dss, ssh-dss-cert-v01@openssh.com, ssh-ed25519, ssh-ed25519-cert-v01@openssh.com, ssh-rsa, ssh-rsa-cert-v01@openssh.com
Algorithmes d’échange de clés autorisés	Liste séparée par des virgules des algorithmes d’échange de clés autorisés pour les connexions SFTP. Laissez le champ libre pour autoriser tout le monde. Les options disponibles sont : curve25519-sha256, curve25519-sha256@libssh.org, diffie-hellman-group-exchange-sha1, diffie-hellman-group-exchange-sha256, diffie-hellman-group1-sha1, diffie-hellman-group14-sha1, diffie-hellman-group14-sha256, diffie-hellman-group14-sha256@ssh.com, diffie-hellman-group15-sha256, diffie-hellman-group15-sha256@ssh.com, diffie-hellman-group15-sha384@ssh.com, diffie-hellman-group15-sha512, diffie-hellman-group16-sha256, diffie-hellman-group16-sha384@ssh.com, diffie-hellman-group16-sha512, diffie-hellman-group16-sha512@ssh.com, diffie-hellman-group17-sha512, diffie-hellman-group18-sha512, diffie-hellman-group18-sha512@ssh.com, ecdh-sha2-nistp256, ecdh-sha2-nistp384, ecdh-sha2-nistp521, ext-info-c
Codes d’authentification des messages autorisés	Une liste de Codes d’authentification des messages autorisés pour les connexions SFTP, séparés par des virgules. Laissez le champ libre pour autoriser tout le monde. Les options disponibles sont : hmac-md5, hmac-md5-96, hmac-md5-96-etm@openssh.com, hmac-md5-etm@openssh.com, hmac-ripemd160, hmac-ripemd160-96, hmac-ripemd160-etm@openssh.com, hmac-ripemd160@openssh.com, hmac-sha1, hmac-sha1-96, hmac-sha1-96@openssh.com, hmac-sha1-etm@openssh.com, hmac-sha2-256, hmac-sha2-256-etm@openssh.com, hmac-sha2-512, hmac-sha2-512-etm@openssh.com
Déplacer le répertoire de destination	Le répertoire du serveur distant dans lequel le fichier original doit être déplacé une fois qu’il a été ingéré dans NiFi. Cette propriété est ignorée sauf si la stratégie d’achèvement est réglée sur Déplacer le fichier. Le répertoire spécifié doit déjà exister sur le système distant si la fonction Créer un répertoire est désactivée, sinon le renommage échouera.
Mot de passe	Mot de passe du compte utilisateur
Port	Le port auquel il faut se connecter sur l’hôte distant pour récupérer les données
Phrase secrète de la clé privée	Mot de passe de la clé privée
Chemin de la clé privée	Le chemin complet du fichier de la clé privée
Fichier distant	Le nom de fichier complet sur le système distant
Envoyer un signal de maintien lors du dépassement du délai	Envoyer un signal de maintien toutes les 5 secondes jusqu’à 5 fois pour un délai d’expiration global de 25 secondes.
Vérification stricte de la clé de l’hôte	Indique si une application stricte des clés d’hôtes doit être mise en œuvre ou non
Utiliser la compression	Indique si la compression ZLIB doit être utilisée ou non lors du transfert de fichiers
NomUtilisateur	NomUtilisateur
fetchfiletransfer-notfound-loglevel	Niveau de journalisation à utiliser dans le cas où le fichier n’existe pas lorsque le processeur est déclenché
service proxy-configuration	Spécifie le Controller Service de configuration proxy pour les requêtes réseau proxy.

Relations¶

Nom	Description
comms.failure	Tout FlowFile qui n’a pas pu être extrait du serveur distant en raison d’une défaillance de communication sera transféré dans cette relation.
not.found	Tout FlowFile pour lequel nous recevons un message « non trouvé » du serveur distant sera transféré vers cette relation.
permission.denied	Tous FlowFile qui n’ont pas pu être extraits du serveur distant en raison d’autorisations insuffisantes seront transférés dans cette relation.
success	Tous les FlowFiles reçus sont routés vers le succès

Écrit les attributs¶

Nom	Description
sftp.remote.host	Le nom d’hôte ou l’adresse IP à partir de laquelle le fichier a été extrait
sftp.remote.port	Le port qui a été utilisé pour communiquer avec le serveur SFTP distant
sftp.remote.filename	Le nom du fichier distant qui a été extrait
filename	Le nom du fichier est mis à jour pour indiquer le nom du fichier distant
path	Si le fichier distant contient un nom de répertoire, ce nom sera ajouté à FlowFile à l’aide de l’attribut « chemin »
fetch.failure.reason	Le nom de la relation de défaillance appliquée lors du routage vers une relation de défaillance quelconque

Cas d’utilisation impliquant d’autres composants¶

Récupérer tous les fichiers d’un répertoire d’un serveur SFTP