FetchSFTP 2025.5.31.15¶

Bundle¶

org.apache.nifi | nifi-standard-nar

Beschreibung¶

Ruft den Inhalt einer Datei von einem Remote-SFTP-Server ab und überschreibt den Inhalt eines eingehenden FlowFile mit dem Inhalt der Remote-Datei.

Tags¶

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

Eingabeanforderung¶

REQUIRED

Unterstützt sensible dynamische Eigenschaften¶

false

Eigenschaften¶

Eigenschaft	Beschreibung
Ciphers Allowed	Eine durch Kommas getrennte Liste der zulässigen Verschlüsselungsverfahren (Chiffren) für SFTP-Verbindungen. Lassen Sie die Option deaktiviert, um alle zuzulassen. Folgende Optionen sind verfügbar: 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
Completion Strategy	Gibt an, was mit der Originaldatei auf dem Server geschehen soll, nachdem sie in NiFi übernommen wurde. Wenn die „Completion Strategy“ fehlschlägt, wird eine Warnung protokolliert, aber die Daten werden trotzdem übertragen.
Connection Timeout	Zeitspanne, die beim Herstellen einer Verbindung gewartet werden muss, bevor ein Timeout auftritt
Create Directory	Wird verwendet, wenn die „Completion Strategy“ „Move File“ ist. Gibt an, ob das Remote-Verzeichnis erstellt werden soll, wenn es nicht vorhanden ist.
Data Timeout	Bei der Übertragung einer Datei zwischen dem lokalen und dem Remote-System gibt dieser Wert an, wie lange keine Daten übertragen werden dürfen, bevor der Vorgang möglicherweise abgebrochen wird.
Disable Directory Listing	Steuert, wie das „Move Destination Directory“ erstellt wird, wenn „Completion Strategy“ „Move File“ ist und „Create Directory“ aktiviert ist. Wenn diese Einstellung auf „true“ gesetzt, wird vor dem Erstellen fehlender Verzeichnisse keine Verzeichnisliste erstellt. Standardmäßig führt dieser Prozessor einen Befehl zum Auflisten von Verzeichnissen aus, um die Existenz von Zielverzeichnissen zu prüfen, bevor er fehlende Verzeichnisse erstellt. Es gibt jedoch Situationen, in denen Sie die Auflistung von Verzeichnissen deaktivieren müssen, wie z. B. in den folgenden Fällen. Das Auflisten von Verzeichnissen kann bei bestimmten Berechtigungseinstellungen (z.  B. chmod 100) fehlschlagen. Wenn ein anderer SFTP-Client das Verzeichnis erstellt hat, nachdem dieser Prozessor eine Auflistung durchgeführt hat und bevor eine Verzeichniserstellungsanforderung dieses Prozessors abgeschlossen ist, wird ein Fehler zurückgegeben, da das Verzeichnis bereits existiert.
Host Key File	Wenn angegeben, wird die angegebene Datei als Host-Schlüssel verwendet. Andernfalls, wenn die Eigenschaft „Strict Host Key Checking“ aktiviert ist (auf „true“ gesetzt), werden die Dateien „known_hosts“ und „known_hosts2“ aus dem Verzeichnis ~/.ssh verwendet, andernfalls wird keine Host-Schlüsseldatei verwendet.
Hostname	Der vollqualifizierte Hostname oder die IP-Adresse des Hosts, von dem die Daten abgerufen werden sollen
Key Algorithms Allowed	Eine durch Kommas getrennte Liste von Schlüsselalgorithmen, die für SFTP-Verbindungen zulässig sind. Lassen Sie die Option deaktiviert, um alle zuzulassen. Folgende Optionen sind verfügbar: 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
Key Exchange Algorithms Allowed	Eine durch Kommas getrennte Liste der für SFTP-Verbindungen zulässigen Schlüsselaustauschalgorithmen. Lassen Sie die Option deaktiviert, um alle zuzulassen. Folgende Optionen sind verfügbar: 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
Message Authentication Codes Allowed	Eine durch Kommas getrennte Liste der für SFTP-Verbindungen zulässigen Meldungsauthentifizierungscodes (MAC). Lassen Sie die Option deaktiviert, um alle zuzulassen. Folgende Optionen sind verfügbar: 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
Move Destination Directory	Das Verzeichnis auf dem entfernten Server, in das die Originaldatei verschoben werden soll, nachdem sie in NiFi aufgenommen wurde. Diese Eigenschaft wird ignoriert, wenn die „Completion Strategy“ nicht auf „Move File“ eingestellt ist. Das angegebene Verzeichnis muss bereits auf dem Remote-System vorhanden sein, wenn „Create Directory“ deaktiviert ist, sonst schlägt die Umbenennung fehl.
Password	Kennwort für das Benutzerkonto
Port	Der Port, zu dem eine Verbindung auf dem Remote-Host hergestellt werden soll, um die Daten von dort zu abzurufen
Private Key Passphrase	Kennwort für den privaten Schlüssel
Private Key Path	Der vollständig qualifizierte Pfad zur Datei des privaten Schlüssels
Remote File	Der vollständig qualifizierte Dateiname auf dem entfernten System
Send Keep Alive On Timeout	Sendet alle 5 Sekunden eine Keep-Alive-Meldung, bis zu 5-mal bei einer Gesamtdauer von 25 Sekunden.
Strict Host Key Checking	Gibt an, ob die strikte Durchsetzung von Hostschlüsseln angewendet werden soll oder nicht.
Use Compression	Zeigt an, ob die ZLIB-Komprimierung bei der Übertragung von Dateien verwendet werden soll oder nicht.
Username	Username
fetchfiletransfer-notfound-loglevel	Protokolliergrad für den Fall, dass die Datei nicht vorhanden, wenn der Prozessor ausgelöst wird
proxy-configuration-service	Gibt den Proxy-Konfigurations-Controller Service an für die Weiterleitung von Netzwerkanforderungen festl.

Beziehungen¶

Name	Beschreibung
comms.failure	Jedes FlowFile, das aufgrund unzureichender Berechtigungen nicht vom Remote-Server abgerufen werden konnte, wird an diese Beziehung übertragen.
not.found	Jedes FlowFile, für das wir vom Remote-Server die Meldung „Not Found“ erhalten, wird an diese Beziehung übertragen.
permission.denied	Jedes FlowFile, das aufgrund unzureichender Berechtigungen nicht vom Remote-Server abgerufen werden konnte, wird an diese Beziehung übertragen.
success	Alle FlowFiles, die empfangen werden, werden an die Beziehung „success“ weitergeleitet.

Schreibt Attribute¶

Name	Beschreibung
sftp.remote.host	Der Hostname oder die IP-Adresse, von denen die Datei abgerufen wurde
sftp.remote.port	Der Port, der für die Kommunikation mit dem Remote-SFTP-Server verwendet wurde
sftp.remote.filename	Der Name der Remote-Datei, die abgerufen wurde
filename	Der Dateiname wird aktualisiert, um auf den Dateinamen der Remote-Datei zu verweisen.
Pfad	Wenn die Remote-Datei einen Verzeichnisnamen enthält, wird dieser Verzeichnisname mit dem Attribut „path“ zum FlowFile hinzugefügt.
fetch.failure.reason	Der Name des „failure“-Beziehung, der bei Weiterleitung an einen „failure“-Beziehung angewendet wird

Anwendungsfälle mit anderen Komponenten¶

Abrufen aller Dateien in einem Verzeichnis auf einem SFTP-Server