Attività FTPFTP Task

L'attività FTP consente di caricare e scaricare file di dati, nonché di gestire directory nei server.The FTP task downloads and uploads data files and manages directories on servers. 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 ServicesIntegration Services .For example, a package can download data files from a remote server or an Internet location as part of an Integration ServicesIntegration Services package workflow. È possibile utilizzare l'attività FTP per gli scopi seguenti:You can use the FTP task for the following purposes:

  • 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.Copying directories and data files from one directory to another, before or after moving data, and applying transformations to the data.

  • Accesso a un percorso FTP di origine e copia di file o pacchetti in una directory di destinazione.Logging in to a source FTP location and copying files or packages to a destination directory.

  • Download di file da un percorso FTP e applicazione di trasformazioni ai dati delle colonne prima del caricamento dei dati in un database.Downloading files from an FTP location and applying transformations to column data before loading the data into a database.

    In fase di esecuzione l'attività FTP si connette a un server tramite una gestione connessione FTPAt run time, the FTP task connects to a server by using an FTP connection manager. configurata separatamente, a cui viene fatto riferimento dall'attività FTP.The FTP connection manager is configured separately from the FTP task, and then is referenced in the FTP task. 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.The FTP connection manager includes the server settings, the credentials for accessing the FTP server, and options such as the time-out and the number of retries for connecting to the server. Per altre informazioni, vedere Gestione connessione FTP.For more information, see FTP Connection Manager.

Importante

La gestione connessione FTP supporta solo l'autenticazione anonima e l'autenticazione di base.The FTP connection manager supports only anonymous authentication and basic authentication. Non supporta l'autenticazione di Windows.It does not support Windows Authentication.

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.When accessing a local file or a local directory, the FTP task uses a File connection manager or path information stored in a variable. 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.In contrast, when accessing a remote file or a remote directory, the FTP task uses a directly specified path on the remote server, as specified in the FTP connection manager, or path information stored in a variable. Per altre informazioni, vedere Gestione connessione file e Variabili di Integration Services (SSIS).For more information, see File Connection Manager and Integration Services (SSIS) Variables.

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.This means that the FTP task can receive multiple files and delete multiple remote files; but the task can send only one file and delete only one local file if it uses a connection manager, because a File connection manager can access only one file. Per accedere a più file locali, è necessario specificarne il percorso utilizzando una variabile.To access multiple local files, the FTP task must use a variable to provide the path information. Una variabile contenente "C:\Test\.txt" specifica ad esempio un percorso per l'eliminazione o l'invio di tutti i file con estensione txt presenti nella directory Test.For example, a variable that contains "C:\Test\.txt" provides a path that supports deleting or sending all the files that have a .txt extension in the Test directory.

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,To send multiple files and access multiple local files and directories, you can also execute the FTP task multiple times by including the task in a Foreach Loop. che è in grado di eseguire un'enumerazione su tutti i file in una directory tramite l'enumeratore For Each File.The Foreach Loop can enumerate across files in a directory using the For Each File enumerator. Per altre informazioni, vedere Contenitore Ciclo Foreach.For more information, see Foreach Loop Container.

L'attività FTP supporta i caratteri jolly punto interrogativo ?The FTP task supports the ? e asterisco \* nei percorsi.and \* wildcard characters in paths. e questo consente di accedere a più file.This lets the task access multiple files. I caratteri jolly possono essere tuttavia utilizzati solo nella parte del percorso che specifica il nome del file.However, you can use wildcard characters only in the part of the path that specifies the file name. Ad esempio, C:\Directory\.txt è un percorso valido, mentre C:\\\Testo.txt non lo è.For example, C:\MyDirectory\.txt is a valid path, but C:\\\MyText.txt is not.

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.The FTP operations can be configured to stop the File System task when the operation fails, or to transfer files in ASCII mode. Le operazioni che inviano e ricevono copie di file possono essere configurate in modo da sovrascrivere i file e le directory di destinazione.The operations that send and receive files copy can be configured to overwrite destination files and directories.

Operazioni FTP predefinitePredefined FTP Operations

L'attività FTP include un set predefinito di operazioni,The FTP task includes a predefined set of operations. descritte nella tabella seguente.The following table describes these operations.

OperazioneOperation DescriptionDescription
Invia fileSend files Invia un file dal computer locale al server FTP.Sends a file from the local computer to the FTP server.
Ricevi fileReceive files Salva sul computer locale un file scaricato dal server FTP.Saves a file from the FTP server to the local computer.
Crea directory localeCreate local directory Crea una cartella sul computer locale.Creates a folder on the local computer.
Crea directory remotaCreate remote directory Crea una cartella sul server FTP.Creates a folder on the FTP server.
Rimuovi directory localeRemove local directory Elimina una cartella dal computer locale.Deletes a folder on the local computer.
Rimuovi directory remotaRemove remote directory Elimina una cartella dal server FTP.Deletes a folder on the FTP server.
Elimina file localiDelete local files Consente di eliminare un file nel computer locale.Deletes a file on the local computer.
Elimina file remotiDelete remote files Consente di eliminare un file nel server FTP.Deletes a file on the FTP server.

Voci di log personalizzate disponibili nell'attività FTPCustom Log Entries Available on the FTP Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività FTP.The following table lists the custom log entries for the FTP task. Per altre informazioni, vedere registrazione di Integration Services (SSIS).For more information, see Integration Services (SSIS) Logging.

Voce di logLog entry DescriptionDescription
FTPConnectingToServerFTPConnectingToServer Indica che l'attività ha stabilito una connessione al server FTP.Indicates that the task initiated a connection to the FTP server.
FTPOperationFTPOperation Specifica l'inizio e il tipo dell'operazione FTP eseguita dall'attività.Reports the beginning of and the type of FTP operation that the task performs.

È possibile impostare le proprietà tramite Progettazione SSISSSIS o a livello di codice.You can set properties through SSISSSIS Designer or programmatically.

Per informazioni su come impostare queste proprietà nella finestra di Progettazione SSISSSIS , vedere Impostare le proprietà di un'attività o di un contenitore.For information about how to set these properties in SSISSSIS Designer, see Set the Properties of a Task or Container.

Per altre informazioni sull'impostazione di queste proprietà a livello di programmazione, vedere FtpTask.For more information about programmatically setting these properties, see FtpTask.

Vedere ancheSee Also

Editor attività FTP (pagina Generale) FTP Task Editor (General Page)
Editor attività FTP ( Pagina di trasferimento di file ) FTP Task Editor (File Transfer Page)
Attività di Integration Services Integration Services Tasks
Flusso di controlloControl Flow