Delen via

FTP-taak

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

De FTP-taak downloadt en uploadt gegevensbestanden en beheert mappen op servers. Een pakket kan bijvoorbeeld gegevensbestanden downloaden van een externe server of een internetlocatie als onderdeel van een Integration Services-pakketwerkstroom. U kunt de FTP-taak voor de volgende doeleinden gebruiken:

  • Mappen en gegevensbestanden kopiëren van de ene map naar de andere, voor of na het verplaatsen van gegevens en het toepassen van transformaties op de gegevens.

  • Aanmelden bij een FTP-bronlocatie en bestanden of pakketten kopiëren naar een doelmap.

  • Bestanden downloaden van een FTP-locatie en transformaties toepassen op kolomgegevens voordat de gegevens in een database worden geladen.

Tijdens runtime maakt de FTP-taak verbinding met een server met behulp van een FTP-verbindingsbeheer. Het FTP-verbindingsbeheer wordt afzonderlijk van de FTP-taak geconfigureerd en wordt vervolgens naar de FTP-taak verwezen. Het FTP-verbindingsbeheer bevat de serverinstellingen, de referenties voor toegang tot de FTP-server en opties zoals de time-out en het aantal nieuwe pogingen om verbinding te maken met de server. Zie FTP Connection Manager voor meer informatie.

Belangrijk

Ftp-verbindingsbeheer ondersteunt alleen anonieme verificatie en basisverificatie. Windows-verificatie wordt niet ondersteund.

Bij het openen van een lokaal bestand of een lokale map gebruikt de FTP-taak een bestandsverbindingsbeheer of padgegevens die zijn opgeslagen in een variabele. Bij het openen van een extern bestand of een externe map gebruikt de FTP-taak daarentegen een rechtstreeks opgegeven pad op de externe server, zoals opgegeven in ftp-verbindingsbeheer of padgegevens die zijn opgeslagen in een variabele. Zie SSIS-variabelen (File Connection Manager en Integration Services) voor meer informatie.

Dit betekent dat de FTP-taak meerdere bestanden kan ontvangen en meerdere externe bestanden kan verwijderen; maar de taak kan slechts één bestand verzenden en slechts één lokaal bestand verwijderen als er een verbindingsbeheer wordt gebruikt, omdat een bestandsverbindingsbeheer slechts toegang heeft tot één bestand. Voor toegang tot meerdere lokale bestanden moet de FTP-taak een variabele gebruiken om de padgegevens op te geven. Een variabele die bijvoorbeeld 'C:\Test*.txt' bevat, biedt een pad dat ondersteuning biedt voor het verwijderen of verzenden van alle bestanden met een .txt-extensie in de map Test.

Als u meerdere bestanden wilt verzenden en toegang wilt krijgen tot meerdere lokale bestanden en mappen, kunt u de FTP-taak ook meerdere keren uitvoeren door de taak op te geven in een Foreach-lus. De Foreach-lus kan alle bestanden in een map inventariseren met behulp van de enumerator voor elk bestand. Zie Foreach Loop Container voor meer informatie.

De FTP-taak ondersteunt de jokertekens ? en * in paden. Hierdoor heeft de taak toegang tot meerdere bestanden. U kunt echter alleen jokertekens gebruiken in het deel van het pad waarmee de bestandsnaam wordt opgegeven. C:\MyDirectory\*.txt is bijvoorbeeld een geldig pad, maar C:\*\MyText.txt niet.

De FTP-bewerkingen kunnen worden geconfigureerd om de bestandssysteemtaak te stoppen wanneer de bewerking mislukt of om bestanden over te dragen in de ASCII-modus. De bewerkingen die het kopiëren van bestanden verzenden en ontvangen, kunnen worden geconfigureerd voor het overschrijven van doelbestanden en mappen.

Vooraf gedefinieerde FTP-bewerkingen

De FTP-taak bevat een vooraf gedefinieerde set bewerkingen. In de volgende tabel worden deze bewerkingen beschreven.

Operation Description
Bestanden verzenden Hiermee wordt een bestand vanaf de lokale computer naar de FTP-server verzonden.
Bestanden ontvangen Slaat een bestand van de FTP-server op de lokale computer op.
Lokale map maken Hiermee maakt u een map op de lokale computer.
Externe map maken Hiermee maakt u een map op de FTP-server.
Lokale map verwijderen Hiermee verwijdert u een map op de lokale computer.
Externe map verwijderen Hiermee verwijdert u een map op de FTP-server.
Lokale bestanden verwijderen Hiermee verwijdert u een bestand op de lokale computer.
Externe bestanden verwijderen Hiermee verwijdert u een bestand op de FTP-server.

Aangepaste logboekvermeldingen beschikbaar voor de FTP-taak

De volgende tabel bevat de aangepaste logboekvermeldingen voor de FTP-taak. Zie Integration Services (SSIS) Loggingvoor meer informatie.

Logboekvermelding Description
FTPConnectingToServer Geeft aan dat de taak een verbinding met de FTP-server heeft gestart.
FTPOperation Rapporteert het begin van en het type FTP-bewerking dat door de taak wordt uitgevoerd.

U kunt eigenschappen instellen via SSIS Designer of programmatisch.

Zie Eigenschappen van een taak of container instellen voor meer informatie over het instellen van deze eigenschappen in SSIS Designer.

Zie voor meer informatie over het programmatisch instellen van deze eigenschappen FtpTask.

FTP-taakeditor (algemene pagina)

Gebruik de pagina Algemeen van het dialoogvenster FTP-taakeditor om het FTP-verbindingsbeheer op te geven dat verbinding maakt met de FTP-server waarmee de taak communiceert. U kunt de FTP-taak ook een naam geven en beschrijven.

Options

FtpConnection
Selecteer een bestaand FTP-verbindingsbeheer of klik op <Nieuwe verbinding...> om een verbindingsbeheer te maken.

Belangrijk

Ftp-verbindingsbeheer ondersteunt alleen anonieme verificatie en basisverificatie. Windows-verificatie wordt niet ondersteund.

Verwante onderwerpen: FTP Connection Manager, FTP Connection Manager Editor

StopOnFailure
Geef aan of de FTP-taak wordt beëindigd als een FTP-bewerking mislukt.

Naam
Geef een unieke naam op voor de FTP-taak. Deze naam wordt gebruikt als het label in het taakpictogram.

Opmerking

Taaknamen moeten uniek zijn binnen een pakket.

Beschrijving
Typ een beschrijving van de FTP-taak.

FTP-taakeditor (pagina bestandsoverdracht)

Gebruik de pagina Bestandsoverdracht van het dialoogvenster FTP-taakeditor om de FTP-bewerking te configureren die door de taak wordt uitgevoerd.

Options

IsRemotePathVariable
Geef aan of het externe pad is opgeslagen in een variabele. Deze eigenschap bevat de opties in de volgende tabel.

Waarde Description
Waar Het doelpad wordt opgeslagen in een variabele. Als u de waarde selecteert, wordt de dynamische optie RemoteVariable weergegeven.
Onwaar Het doelpad wordt opgegeven in een bestandsverbindingsbeheer. Als u de waarde selecteert, wordt de dynamische optie RemotePath weergegeven.

BestandOverschrijvenOpBestemming
Geef op of een bestand op de bestemming kan worden overschreven.

IsLocalPathVariable
Geef aan of het lokale pad is opgeslagen in een variabele. Deze eigenschap bevat de opties in de volgende tabel.

Waarde Description
Waar Het doelpad wordt opgeslagen in een variabele. Als u de waarde selecteert, wordt de dynamische optie LocalVariable weergegeven.
Onwaar Het doelpad wordt opgegeven in een bestandsverbindingsbeheer. Als u de waarde selecteert, wordt de dynamische optie LocalPath weergegeven.

Operation
Selecteer de FTP-bewerking die u wilt uitvoeren. Deze eigenschap bevat de opties in de volgende tabel.

Waarde Description
Bestanden verzenden Bestanden verzenden. Als u deze waarde selecteert, worden de dynamische opties LocalVariable, LocalPathRemoteVariable en RemotePath weergegeven.
Bestanden ontvangen Bestanden ontvangen. Als u deze waarde selecteert, worden de dynamische opties LocalVariable, LocalPathRemoteVariable en RemotePath weergegeven.
Lokale map maken Maak een lokale map. Als u deze waarde selecteert, worden de dynamische opties LocalVariable en LocalPath weergegeven.
Externe map maken Maak een externe map. Als u deze waarde selecteert, worden de dynamische opties RemoteVariable en RemotePath weergegeven.
Lokale map verwijderen Hiermee verwijdert u een lokale map. Als u deze waarde selecteert, worden de dynamische opties LocalVariable en LocalPath weergegeven.
Externe map verwijderen Een externe map verwijderen. Als u deze waarde selecteert, worden de dynamische opties RemoteVariable en RemotePath weergegeven.
Lokale bestanden verwijderen Lokale bestanden verwijderen. Als u deze waarde selecteert, worden de dynamische opties LocalVariable en LocalPath weergegeven.
Externe bestanden verwijderen Externe bestanden verwijderen. Als u deze waarde selecteert, worden de dynamische opties RemoteVariable en RemotePath weergegeven.

IsTransferASCII
Geef aan of bestanden die worden overgebracht naar en van de externe FTP-server moeten worden overgedragen in de ASCII-modus.

Dynamische opties voor IsRemotePathVariable

IsRemotePathVariable = True

RemoteVariable
Selecteer een bestaande door de gebruiker gedefinieerde variabele of klik op <Nieuwe variabele...> om een door de gebruiker gedefinieerde variabele te maken.

Verwante onderwerpen:SSIS-variabelen (Integration Services), variabele toevoegen

IsRemotePathVariable = False

RemotePath
Selecteer een bestaand FTP-verbindingsbeheer of klik op <Nieuwe verbinding...> om een verbindingsbeheer te maken.

Verwante onderwerpen:FTP Connection Manager, FTP Connection Manager Editor

Dynamische opties voor IsLocalPathVariable

IsLocalPathVariable = True

LocalVariable
Selecteer een bestaande door de gebruiker gedefinieerde variabele of klik op <Nieuwe variabele...> om een variabele te maken.

Verwante onderwerpen:SSIS-variabelen (Integration Services), variabele toevoegen

IsLocalPathVariable = False

LocalPath
Selecteer een bestaand bestandsverbindingsbeheer of klik op <Nieuwe verbinding...> om een verbindingsbeheer te maken.

Verwante onderwerpen: Plat bestandsverbindingsbeheer

Zie ook

Integration Servicestaken
controlestroom

  • Last updated on