Attività FTP

  • Articolo

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

L'attività FTP consente di caricare e scaricare file di dati, nonché di gestire directory nei server. Un pacchetto può ad esempio scaricare file di dati da un server remoto o da un indirizzo Internet nell'ambito del flusso di lavoro di un pacchetto di Integration Services. È possibile utilizzare l'attività FTP per gli scopi seguenti:

  • Copia di directory e file di dati da una directory all'altra, prima o dopo lo spostamento dei dati, e applicazione di trasformazioni ai dati.

  • Accesso a un percorso FTP di origine e copia di file o pacchetti in una directory di destinazione.

  • Download di file da un percorso FTP e applicazione di trasformazioni ai dati delle colonne prima del caricamento dei dati in un database.

In fase di esecuzione l'attività FTP si connette a un server tramite una gestione connessione FTP configurata separatamente, a cui viene fatto riferimento dall'attività FTP. La gestione connessione FTP include le impostazioni del server, le credenziali per l'accesso al server FTP e opzioni quali il timeout e il numero dei tentativi consentiti per la connessione al server. Per altre informazioni, vedere Gestione connessione FTP.

Importante

La gestione connessione FTP supporta solo l'autenticazione anonima e l'autenticazione di base. Non supporta l'autenticazione di Windows.

Per l'accesso a un file o a una directory locale, l'attività FTP utilizza un percorso archiviato in una variabile o una gestione connessione file. Per l'accesso a un file o a una directory remota, invece, l'attività FTP utilizza un percorso archiviato in una variabile oppure specificato direttamente sul server remoto, come indicato nella gestione connessione FTP. Per altre informazioni, vedere Gestione connessione File e Variabili di Integration Services (SSIS).

Questo significa che l'attività FTP può ricevere più file ed eliminare più file remoti, ma se utilizza una gestione connessione può inviare ed eliminare un solo file locale alla volta, poiché una gestione connessione file può accedere a un solo file. Per accedere a più file locali, è necessario specificarne il percorso utilizzando una variabile. Ad esempio, una variabile contenente "C:\Test*. txt" fornisce un percorso che supporta l'eliminazione o l'invio di tutti i file con estensione txt nella directory Test.

In alternativa, per inviare più file e accedere a più file e directory locali è possibile eseguire più volte l'attività FTP includendola in un ciclo Foreach, che è in grado di eseguire un'enumerazione su tutti i file in una directory tramite l'enumeratore For Each File. Per altre informazioni, vedere Contenitore Ciclo Foreach.

L'attività FTP supporta l'utilizzo dei caratteri jolly ? e * nell'indicazione dei percorsi. e questo consente di accedere a più file. I caratteri jolly possono essere tuttavia utilizzati solo nella parte del percorso che specifica il nome del file. Ad esempio, C:\MyDirectory\*.txt è un percorso valido, ma C:\*\MyText.txt non è.

Le operazioni FTP possono essere configurate in modo da arrestare l'attività File system se l'operazione non riesce oppure in modo da trasferire i file in modalità ASCII. Le operazioni che inviano e ricevono copie di file possono essere configurate in modo da sovrascrivere i file e le directory di destinazione.

Operazioni FTP predefinite

L'attività FTP include un set predefinito di operazioni, descritte nella tabella seguente.

Operazione Descrizione
Invia file Invia un file dal computer locale al server FTP.
Ricevi file Salva sul computer locale un file scaricato dal server FTP.
Crea directory locale Crea una cartella sul computer locale.
Crea directory remota Crea una cartella sul server FTP.
Rimuovi directory locale Elimina una cartella dal computer locale.
Rimuovi directory remota Elimina una cartella dal server FTP.
Elimina file locali Consente di eliminare un file nel computer locale.
Elimina file remoti Consente di eliminare un file nel server FTP.

Voci di log personalizzate disponibili nell'attività FTP

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività FTP. Per altre informazioni, vedere Registrazione di Integration Services (SSIS).

Voce di log Descrizione
FTPConnectingToServer Indica che l'attività ha stabilito una connessione al server FTP.
FTPOperation Specifica l'inizio e il tipo dell'operazione FTP eseguita dall'attività.

È possibile impostare le proprietà tramite Progettazione SSIS o a livello di codice.

Per informazioni su come impostare queste proprietà nella finestra di Progettazione SSIS, vedere Impostare le proprietà di un'attività o di un contenitore.

Per altre informazioni sull'impostazione di queste proprietà a livello di programmazione, vedere FtpTask.

Editor attività FTP (pagina Generale)

Utilizzare la pagina Generale della finestra di dialogo Editor attività FTP per specificare la gestione connessione FTP tramite cui viene stabilita la connessione al server FTP con cui comunica l'attività. È inoltre possibile specificare un nome e una descrizione per l'attività FTP.

Opzioni

FtpConnection
Consente di selezionare una gestione connessione FTP esistente o di creare una gestione connessione facendo clic su <Nuova connessione>.

Importante

La gestione connessione FTP supporta solo l'autenticazione anonima e l'autenticazione di base. Non supporta l'autenticazione di Windows.

Argomenti correlati: FTP Connection Manager, FTP Connection Manager Editor

StopOnFailure
Consente di specificare il termine dell'attività FTP in caso di esito negativo di un'operazione FTP.

Nome
Consente di specificare un nome univoco per l'attività FTP. Tale nome viene utilizzato come etichetta nell'icona dell'attività.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.

Descrizione
Consente di digitare una descrizione dell'attività FTP.

Editor attività FTP (pagina Trasferimento file)

Usare la pagina Trasferimento file della finestra di dialogo Editor attività FTP per configurare l'operazione FTP eseguita dall'attività.

Opzioni

IsRemotePathVariable
Consente di specificare se il percorso remoto è archiviato in una variabile. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.

Valore Descrizione
Vero Il percorso di destinazione è archiviato in una variabile. Selezionando il valore viene visualizzata l'opzione dinamica RemoteVariable.
Falso Il percorso di destinazione è specificato in una gestione connessione file. Selezionando il valore viene visualizzata l'opzione dinamica RemotePath.

OverwriteFileAtDestination
Consente di specificare se è possibile sovrascrivere un file nella destinazione.

IsLocalPathVariable
Consente di specificare se il percorso locale è archiviato in una variabile. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.

Valore Descrizione
Vero Il percorso di destinazione è archiviato in una variabile. Selezionando il valore viene visualizzata l'opzione dinamica LocalVariable.
Falso Il percorso di destinazione è specificato in una gestione connessione file. Selezionando il valore viene visualizzata l'opzione dinamica LocalPath.

Operazione
Consente di selezionare l'operazione FTP da eseguire. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.

Valore Descrizione
Invia file Consente di inviare i file. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable, LocalPathRemoteVariable e RemotePath.
Ricevi file Consente di ricevere i file. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable, LocalPathRemoteVariable e RemotePath.
Crea directory locale Consente di creare una directory locale. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable e LocalPath.
Crea directory remota Consente di creare una directory remota. Selezionando questo valore vengono visualizzate le opzioni dinamiche RemoteVariable e RemotelPath.
Rimuovi directory locale Consente di rimuovere una directory locale. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable e LocalPath.
Rimuovi directory remota Consente di rimuovere una directory remota. Selezionando questo valore vengono visualizzate le opzioni dinamiche RemoteVariable e RemotePath.
Elimina file locali Consente di eliminare file locali. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable e LocalPath.
Elimina file remoti Consente di eliminare file remoti. Selezionando questo valore vengono visualizzate le opzioni dinamiche RemoteVariable e RemotePath.

IsTransferASCII
Consente di specificare se i file ricevuti e inviati dal server FTP remoto devono essere trasferiti in modalità ASCII.

Opzioni dinamiche di IsRemotePathVariable

IsRemotePathVariable = True

RemoteVariable
Consente di selezionare una variabile esistente definita dall'utente o di creare una variabile definita dall'utente facendo clic su <Nuova variabile>.

Argomenti correlati:Variabili di Integration Services (SSIS), Aggiungere una variabile

IsRemotePathVariable = False

RemotePath
Consente di selezionare una gestione connessione FTP esistente o di creare una gestione connessione facendo clic su <Nuova connessione>.

Argomenti correlati:Gestione connessione FTP, Editor gestione connessione FTP

Opzioni dinamiche di IsLocalPathVariable

IsLocalPathVariable = True

LocalVariable
Consente di selezionare una variabile esistente definita dall'utente o di creare una variabile facendo clic su <Nuova variabile>.

Argomenti correlati:Variabili di Integration Services (SSIS), Aggiungere una variabile

IsLocalPathVariable = False

LocalPath
Selezionare una gestione connessione file esistente oppure crearne una nuova facendo clic su <Nuova connessione>.

Argomenti correlati:Gestione connessione file flat

Vedi anche

Attività di Integration Services
Flusso di controllo