FTP-uppgift

gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

FTP-uppgiften laddar ned och laddar upp datafiler och hanterar kataloger på servrar. Ett paket kan till exempel ladda ned datafiler från en fjärrserver eller en Internetplats som en del av ett Integration Services-paketarbetsflöde. Du kan använda FTP-uppgiften i följande syfte:

• Kopiera kataloger och datafiler från en katalog till en annan, före eller efter flytt av data och tillämpa transformeringar på data.

• Logga in på en FTP-källplats och kopiera filer eller paket till en målkatalog.

• Ladda ned filer från en FTP-plats och tillämpa transformeringar på kolumndata innan data läses in i en databas.

Vid körning ansluter FTP-uppgiften till en server med hjälp av en FTP-anslutningshanterare. FTP-anslutningshanteraren konfigureras separat från FTP-aktiviteten och refereras sedan till i FTP-aktiviteten. FTP-anslutningshanteraren innehåller serverinställningarna, autentiseringsuppgifterna för åtkomst till FTP-servern och alternativ som timeout och antalet återförsök för att ansluta till servern. Mer information finns i FTP Connection Manager.

Vid åtkomst till en lokal fil eller en lokal katalog använder FTP-aktiviteten en filanslutningshanterare eller sökvägsinformation som lagras i en variabel. Vid åtkomst till en fjärrfil eller en fjärrkatalog använder FTP-aktiviteten däremot en direkt angiven sökväg på fjärrservern, som anges i FTP-anslutningshanteraren, eller sökvägsinformation som lagras i en variabel. Mer information finns i File Connection Manager och Integration Services-variabler (SSIS).

Det innebär att FTP-uppgiften kan ta emot flera filer och ta bort flera fjärrfiler. men uppgiften kan bara skicka en fil och bara ta bort en lokal fil om den använder en anslutningshanterare, eftersom en filanslutningshanterare bara kan komma åt en fil. För att få åtkomst till flera lokala filer måste FTP-aktiviteten använda en variabel för att ange sökvägsinformationen. Till exempel en variabel som innehåller "C:\Test*.txt" innehåller en sökväg som stöder borttagning eller sändning av alla filer som har ett .txt-tillägg i testkatalogen.

Om du vill skicka flera filer och få åtkomst till flera lokala filer och kataloger kan du även köra FTP-uppgiften flera gånger genom att inkludera uppgiften i en Foreach-loop. Foreach-loopen kan räkna upp mellan filer i en katalog med hjälp av uppräknaren För varje fil. Mer information finns i Foreach Loop Container.

FTP-uppgiften stöder ? och * jokertecken i sökvägar. På så sätt kan aktiviteten komma åt flera filer. Du kan dock bara använda jokertecken i den del av sökvägen som anger filnamnet. C:\MyDirectory\*.txt är till exempel en giltig sökväg, men C:\*\MyText.txt är det inte.

FTP-åtgärderna kan konfigureras för att stoppa filsystemaktiviteten när åtgärden misslyckas eller för att överföra filer i ASCII-läge. De åtgärder som skickar och tar emot filer kan konfigureras för att skriva över målfiler och kataloger.

Fördefinierade FTP-åtgärder

FTP-aktiviteten innehåller en fördefinierad uppsättning åtgärder. I följande tabell beskrivs dessa åtgärder.

Anpassade loggposter som är tillgängliga för FTP-aktiviteten

I följande tabell visas de anpassade loggposterna för FTP-aktiviteten. Mer information finns i loggning Integration Services (SSIS).

Relaterade uppgifter

Du kan ange egenskaper via SSIS Designer eller programmatiskt.

Information om hur du anger dessa egenskaper i SSIS Designer finns i Ange egenskaper för en aktivitet eller container.

Mer information om hur du ställer in dessa egenskaper programmatiskt finns i FtpTask.

FTP-aktivitetsredigeraren (allmän sida)

Använd sidan Allmänt i dialogrutan FTP-uppgiftsredigeraren för att ange den FTP-anslutningshanterare som ansluter till FTP-servern som aktiviteten kommunicerar med. Du kan också namnge och beskriva FTP-uppgiften.

Alternativ

FtpConnection
Välj en befintlig FTP-anslutningshanterare eller klicka på <Ny anslutning...> för att skapa en anslutningshanterare.

Relaterade ämnen: FTP Connection Manager, FTP Connection Manager Editor

StopOnFailure
Ange om FTP-aktiviteten avslutas om en FTP-åtgärd misslyckas.

Namn
Ange ett unikt namn för FTP-aktiviteten. Det här namnet används som etikett i aktivitetsikonen.

Beskrivning
Ange en beskrivning av FTP-aktiviteten.

FTP-aktivitetsredigeraren (filöverföringssida)

Använd sidan Filöverföring i dialogrutan FTP-uppgiftsredigeraren för att konfigurera FTP-åtgärden som aktiviteten utför.

Alternativ

IsRemotePathVariable
Ange om fjärrsökvägen lagras i en variabel. Den här egenskapen innehåller alternativen i följande tabell.

SkrivöverFilVidDestination
Ange om en fil på destinationsplatsen ska kunna skrivas över.

IsLocalPathVariable
Ange om den lokala sökvägen lagras i en variabel. Den här egenskapen innehåller alternativen i följande tabell.

Åtgärd
Välj den FTP-åtgärd som ska utföras. Den här egenskapen innehåller alternativen i följande tabell.

IsTransferASCII
Ange om filer som överförs till och från fjärr-FTP-servern ska överföras i ASCII-läge.

Dynamiska IsRemotePathVariable-alternativ

IsRemotePathVariable = True

Fjärrvariabel
Välj en befintlig användardefinierad variabel eller klicka på <Ny variabel...> för att skapa en användardefinierad variabel.

Relaterade Ämnen:Integration Services-variabler (SSIS), Lägg Till Variabel

IsRemotePathVariable = False

RemotePath
Välj en befintlig FTP-anslutningshanterare eller klicka på <Ny anslutning...> för att skapa en anslutningshanterare.

Relaterade ämnen:FTP Connection Manager, FTP Connection Manager Editor

Dynamiska alternativ för isLocalPathVariable

IsLocalPathVariable = True

LocalVariable
Välj en befintlig användardefinierad variabel eller klicka på <Ny variabel...> för att skapa en variabel.

Relaterade ämnen:Integration Services-variabler (SSIS), Lägg till variabel

IsLocalPathVariable = Falsk

LocalPath
Välj en befintlig filanslutningshanterare eller klicka på <Ny anslutning...> för att skapa en anslutningshanterare.

Relaterade Ämnen: Flat File Connection Manager

Se även

Integration Services-uppgifter
Kontrollflöde