Share via


FTP-Task

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.

Wichtiger HinweisWichtig

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 Dateiverbindungs-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.

Operation

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) und Benutzerdefinierte Meldungen für die Protokollierung.

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.

Verwandte Tasks

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

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

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

Verwandte Inhalte

Integration Services (kleines Symbol) Bleiben Sie mit Integration Services auf dem neuesten Stand

Die neuesten Downloads, Artikel, Beispiele und Videos von Microsoft sowie ausgewählte Lösungen aus der Community finden Sie auf MSDN auf der Integration Services-Seite:


Abonnieren Sie die auf der Seite verfügbaren RSS-Feeds, um automatische Benachrichtigungen zu diesen Updates zu erhalten.

Siehe auch

Verweis

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

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

Konzepte

Integration Services-Tasks

Ablaufsteuerung