FTP-Task

Aktualisiert: 17. Juli 2006

Mit dem FTP-Task werden Datendateien gedownloadet und geuploadet sowie Verzeichnisse auf Servern verwaltet. Beispielsweise kann ein Paket Datendateien von einem Remoteserver oder einem Internetstandort als Teil eines Paketworkflows von Integration Services downloaden. 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.
  • Downloaden 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.

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 SQL Server Integration Services-Variablen.

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.

Sonstige verwandte Tasks

Integration Services schließt einen Task ein, der Operationen für Dateien und Verzeichnisse im Dateisystem ausführt.

Klicken Sie auf das folgende Thema, um weitere Informationen zu diesem Task zu erhalten:

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 Implementieren der Protokollierung in Pakete und Benutzerdefinierte Meldungen für die Protokollierung.

Protokolleintrag Description

FTPConnectingToServer

Zeigt an, dass mit dem Task eine Verbindung zum FTP-Server initiiert wurde.

FTPOperation

Gibt den Beginn und Typ des vom Task durchgeführten FTP-Vorgangs an.

Konfigurieren des FTP-Tasks

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

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im SSIS-Designer festlegen können:

Klicken Sie auf das folgende Thema, um weitere Informationen zum Festlegen dieser Eigenschaften im SSIS-Designer zu erhalten:

Programmgesteuertes Konfigurieren des FTP-Tasks

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zum programmgesteuerten Festlegen dieser Eigenschaften zu erhalten:

Siehe auch

Konzepte

Integration Services-Tasks
Erstellen einer Paketablaufsteuerung

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version Verlauf

17. Juli 2006

Geänderter Inhalt:
  • Eine Tabelle mit benutzerdefinierten Protokolleinträgen wurde hinzugefügt.