Freigeben über

FTP-Task

  • Artikel

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

Mit dem FTP-Task werden Datendateien heruntergeladen und hochgeladen sowie Verzeichnisse auf Servern verwaltet. Beispielsweise kann ein Paket Datendateien von einem Remoteserver oder einem Internetstandort als Teil eines Paket-Workflows von Integration Services herunterladen. Der FTP-Task kann für folgende Zwecke verwendet werden:

  • Kopieren von Verzeichnissen und Datendateien zwischen Verzeichnissen, vor oder nach dem Verschieben von Daten, sowie Anwenden von Transformationen auf die Daten.

  • Anmelden bei einer FTP-Quelladresse und Kopieren von Dateien oder Paketen in ein Zielverzeichnis.

  • Das Herunterladen von Dateien von einer FTP-Adresse und Anwenden von Transformationen auf Spaltendaten, bevor die Daten in eine Datenbank geladen werden.

Zur Laufzeit stellt der FTP-Task mithilfe eines FTP-Verbindungs-Managers eine Verbindung mit einem Server her. Der FTP-Verbindungs-Manager wird separat vom FTP-Task konfiguriert, und im FTP-Task wird dann darauf verwiesen. Der FTP-Verbindungs-Manager schließt die Servereinstellungen, die Anmeldeinformationen für den Zugriff auf den FTP-Server ein sowie Optionen wie z. B. das Timeout und die Anzahl von Verbindungsversuchen mit dem Server. Weitere Informationen finden Sie unter FTP-Verbindungs-Manager.

Wichtig

Der FTP-Verbindungs-Manager unterstützt nur die anonyme Authentifizierung und die Standardauthentifizierung. Er unterstützt keine Windows-Authentifizierung.

Für den Zugriff auf eine lokale Datei oder ein lokales Verzeichnis verwendet der FTP-Task einen Dateiverbindungs-Manager oder Pfadinformationen, die in einer Variablen gespeichert sind. Dagegen verwendet der FTP-Task für den Zugriff auf eine Remotedatei oder ein Remoteverzeichnis einen direkt eingegebenen Pfad auf dem Remoteserver, der im FTP-Verbindungs-Manager angegeben ist, oder in einer Variablen gespeicherte Pfadinformationen. Weitere Informationen finden Sie unter File Connection Manager und Integration Services-Variablen (SSIS).

Dies bedeutet, dass mit dem FTP-Task mehrere Dateien empfangen und mehrere Remotedateien gelöscht werden können. Mit diesem Task kann jedoch nur eine Datei gesendet und eine lokale Datei gelöscht werden, falls ein Verbindungs-Manager verwendet wird. Ein Dateiverbindungs-Manager kann nämlich nur auf eine Datei zugreifen. Für den Zugriff auf mehrere lokale Dateien muss der FTP-Task eine Variable zum Bereitstellen der Pfadinformationen verwenden. Beispielsweise stellt eine Variable, die „C:\Test*.txt“ enthält, einen Pfad bereit, der das Löschen oder Senden aller Dateien mit der Erweiterung TXT im Verzeichnis „Test“ unterstützt.

Um mehrere Dateien zu senden und auf mehrere lokale Dateien und Verzeichnisse zuzugreifen, können Sie den FTP-Task auch mehrmals ausführen, indem Sie den Task in eine Foreach-Schleife einschließen. Mit der Foreach-Schleife ist die Enumeration von Dateien in einem Verzeichnis mithilfe des Foreach-Dateienumerators möglich. Weitere Informationen finden Sie unter Foreach-Schleifencontainer.

Der FTP-Task unterstützt die Platzhalterzeichen ? und * in Pfaden. Auf diese Weise kann mit dem Task auf mehrere Dateien zugegriffen werden. Platzhalterzeichen können jedoch nur in dem Teil des Pfades verwendet werden, in dem der Dateiname angegeben ist. Beispielsweise ist C:\MyDirectory\*.txt ein gültiger Pfad, C:\*\MyText.txt dagegen nicht.

Die FTP-Vorgänge können so konfiguriert werden, dass der Task Dateisystem beendet wird, wenn der Vorgang einen Fehler erzeugt, oder dass Dateien im ASCII-Modus übertragen werden. Die Vorgänge, mit denen Dateien gesendet und empfangen werden, können so konfiguriert werden, dass Zieldateien und -verzeichnisse überschrieben werden.

Vordefinierte FTP-Vorgänge

Der FTP-Task schließt vordefinierte Vorgänge ein. In der folgenden Tabelle werden diese Vorgänge beschrieben.

Vorgang BESCHREIBUNG
Dateien senden Sendet eine Datei vom lokalen Computer an den FTP-Server.
Dateien empfangen Speichert eine Datei vom FTP-Server auf dem lokalen Computer.
Lokales Verzeichnis erstellen Erstellt einen Ordner auf dem lokalen Computer.
Remoteverzeichnis erstellen Erstellt einen Ordner auf dem FTP-Server.
Lokales Verzeichnis entfernen Löscht einen Ordner auf dem lokalen Computer.
Remoteverzeichnis entfernen Löscht einen Ordner auf dem FTP-Server.
Lokale Dateien löschen Löscht eine Datei auf dem lokalen Computer.
Remotedateien löschen Löscht eine Datei auf dem FTP-Server.

Verfügbare benutzerdefinierte Protokolleinträge für den FTP-Task

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den FTP-Task aufgelistet. Weitere Informationen finden Sie unter Integration Services-Protokollierung (SSIS).

Protokolleintrag BESCHREIBUNG
FTPConnectingToServer Zeigt an, dass mit dem Task eine Verbindung zum FTP-Server initiiert wurde.
FTPOperation Berichtet den Beginn und Typ des vom Task ausgeführten FTP-Vorgangs.

Sie können Eigenschaften mit dem SSIS -Designer oder programmgesteuert festlegen.

Informationen zum Anzeigen dieser Eigenschaften im SSIS-Designer finden Sie unter Festlegen der Eigenschaften eines Tasks oder Containers.

Weitere Informationen zum programmgesteuerten Festlegen dieser Eigenschaften finden Sie unter FtpTask.

Editor für den FTP-Task (Seite Allgemein)

Mithilfe der Seite Allgemein des Dialogfelds Editor für den FTP-Task können Sie den FTP-Verbindungs-Manager angeben, der die Verbindung mit dem FTP-Server herstellt, mit dem der Task kommuniziert. Sie können den FTP-Task außerdem benennen und eine Beschreibung hinzufügen.

Tastatur

FtpConnection
Wählen Sie einen vorhandenen FTP-Verbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung>, um einen Verbindungs-Manager zu erstellen.

Wichtig

Der FTP-Verbindungs-Manager unterstützt nur die anonyme Authentifizierung und die Standardauthentifizierung. Er unterstützt keine Windows-Authentifizierung.

Verwandte Themen:FTP-Verbindungs-Manager, FTP-Verbindungs-Manager-Editor

StopOnFailure
Geben Sie an, ob der FTP-Task beendet wird, wenn ein FTP-Vorgang fehlschlägt.

Name
Geben Sie einen eindeutigen Namen für den FTP-Task an. Dieser Name wird im Tasksymbol als Bezeichnung verwendet.

Hinweis

Tasknamen müssen innerhalb eines Pakets eindeutig sein.

Beschreibung
Geben Sie eine Beschreibung des FTP-Tasks ein.

Editor für den FTP-Task (Seite Dateiübertragung)

Mithilfe der Seite Dateiübertragung des Dialogfelds Editor für den FTP-Task können Sie den FTP-Vorgang konfigurieren, der durch den Task ausgeführt wird.

Tastatur

IsRemotePathVariable
Geben Sie an, ob der Remotepfad in einer Variablen gespeichert ist. Diese Eigenschaft besitzt die in der folgenden Tabelle aufgeführten Optionen.

Wert Beschreibung
Wahr Der Zielpfad ist in einer Variablen gespeichert. Wenn Sie diesen Wert auswählen, wird die dynamische Option RemoteVariableangezeigt.
False Der Zielpfad wird in einem Dateiverbindungs-Manager angegeben. Wenn Sie diesen Wert auswählen, wird die dynamische Option RemotePathangezeigt.

OverwriteFileAtDestination
Geben Sie an, ob eine Datei am Ziel überschrieben werden kann.

IsLocalPathVariable
Geben Sie an, ob der lokale Pfad in einer Variablen gespeichert ist. Diese Eigenschaft besitzt die in der folgenden Tabelle aufgeführten Optionen.

Wert Beschreibung
Wahr Der Zielpfad ist in einer Variablen gespeichert. Wenn Sie diesen Wert auswählen, wird die dynamische Option LocalVariableangezeigt.
False Der Zielpfad wird in einem Dateiverbindungs-Manager angegeben. Wenn Sie diesen Wert auswählen, wird die dynamische Option LocalPathangezeigt.

Vorgang
Wählen Sie den auszuführenden FTP-Vorgang aus. Diese Eigenschaft besitzt die in der folgenden Tabelle aufgeführten Optionen.

Wert BESCHREIBUNG
Dateien senden Senden Sie Dateien. Wenn Sie diesen Wert auswählen, werden die dynamischen Optionen LocalVariable, LocalPathRemoteVariable und RemotePathangezeigt.
Dateien empfangen Empfangen Sie Dateien. Wenn Sie diesen Wert auswählen, werden die dynamischen Optionen LocalVariable, LocalPathRemoteVariable und RemotePathangezeigt.
Lokales Verzeichnis erstellen Erstellen Sie ein lokales Verzeichnis. Wenn Sie diesen Wert auswählen, werden die dynamischen Optionen LocalVariable und LocalPathangezeigt.
Remoteverzeichnis erstellen Erstellen Sie ein Remoteverzeichnis. Wenn Sie diesen Wert auswählen, werden die dynamischen Optionen RemoteVariable und RemotePathangezeigt.
Lokales Verzeichnis entfernen Entfernen Sie ein lokales Verzeichnis. Wenn Sie diesen Wert auswählen, werden die dynamischen Optionen LocalVariable und LocalPathangezeigt.
Remoteverzeichnis entfernen Entfernen Sie ein Remoteverzeichnis. Wenn Sie diesen Wert auswählen, werden die dynamischen Optionen RemoteVariable und RemotePathangezeigt.
Lokale Dateien löschen Löschen Sie lokale Dateien. Wenn Sie diesen Wert auswählen, werden die dynamischen Optionen LocalVariable und LocalPathangezeigt.
Remotedateien löschen Löschen Sie Remotedateien. Wenn Sie diesen Wert auswählen, werden die dynamischen Optionen RemoteVariable und RemotePathangezeigt.

IsTransferASCII
Geben Sie an, ob die auf und von einem Remote-FTP-Server übertragenen Dateien im ASCII-Modus übertragen werden sollen.

IsRemotePathVariable (dynamische Optionen)

IsRemotePathVariable = True

RemoteVariable
Wählen Sie eine vorhandene benutzerdefinierte Variable aus, oder klicken Sie auf <Neue Variable>, um eine benutzerdefinierte Variable zu erstellen.

Verwandte Themen: Variablen von Integrationsdiensten (SSIS), Hinzufügen von Variablen

IsRemotePathVariable = False

RemotePath
Wählen Sie einen vorhandenen FTP-Verbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung>, um einen Verbindungs-Manager zu erstellen.

Verwandte Themen:FTP-Verbindungs-Manager, FTP-Verbindungs-Manager-Editor

IsLocalPathVariable (dynamische Optionen)

IsLocalPathVariable = True

LocalVariable
Wählen Sie eine vorhandene benutzerdefinierte Variable aus, oder klicken Sie auf <Neue Variable>, um eine Variable zu erstellen.

Verwandte Themen: Variablen von Integrationsdiensten (SSIS), Hinzufügen von Variablen

IsLocalPathVariable = False

LocalPath
Wählen Sie einen vorhandenen Dateiverbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung>, um einen Verbindungs-Manager zu erstellen.

Verwandte Themen:Verbindungs-Manager für Flatfiles

Weitere Informationen

Integration Services-Tasks
Ablaufsteuerung