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.

Editor attività FTP (pagina Generale)FTP Task Editor (General Page)

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à.Use the General page of the FTP Task Editor dialog box to specify the FTP connection manager that connects to the FTP server that the task communicates with. È inoltre possibile specificare un nome e una descrizione per l'attività FTP.You can also name and describe the FTP task.

OpzioniOptions

FtpConnectionFtpConnection
Selezionare una gestione connessione FTP esistente o fare clic su < nuova connessione... > per creare una gestione connessione.Select an existing FTP connection manager, or click <New connection...> to create a 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.

Argomenti correlati: FTP Connection Manager, FTP Connection Manager EditorRelated Topics: FTP Connection Manager, FTP Connection Manager Editor

StopOnFailureStopOnFailure
Consente di specificare il termine dell'attività FTP in caso di esito negativo di un'operazione FTP.Indicate whether the FTP task terminates if an FTP operation fails.

NomeName
Consente di specificare un nome univoco per l'attività FTP.Provide a unique name for the FTP task. Tale nome viene utilizzato come etichetta nell'icona dell'attività.This name is used as the label in the task icon.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.Task names must be unique within a package.

DescriptionDescription
Consente di digitare una descrizione dell'attività FTP.Type a description of the FTP task.

Editor attività FTP (pagina Trasferimento file)FTP Task Editor (File Transfer Page)

Usare la pagina Trasferimento file della finestra di dialogo Editor attività FTP per configurare l'operazione FTP eseguita dall'attività.Use the File Transfer page of the FTP Task Editor dialog box to configure the FTP operation that the task performs.

OpzioniOptions

IsRemotePathVariableIsRemotePathVariable
Consente di specificare se il percorso remoto è archiviato in una variabile.Indicate whether the remote path is stored in a variable. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.This property has the options listed in the following table.

ValoreValue DescriptionDescription
TrueTrue Il percorso di destinazione è archiviato in una variabile.The destination path is stored in a variable. Selezionando il valore viene visualizzata l'opzione dinamica RemoteVariable.Selecting the value displays the dynamic option, RemoteVariable.
FalseFalse Il percorso di destinazione è specificato in una gestione connessione file.The destination path is specified in a File connection manager. Selezionando il valore viene visualizzata l'opzione dinamica RemotePath.Selecting the value displays the dynamic option, RemotePath.

OverwriteFileAtDestinationOverwriteFileAtDestination
Consente di specificare se è possibile sovrascrivere un file nella destinazione.Specify whether a file at the destination can be overwritten.

IsLocalPathVariableIsLocalPathVariable
Consente di specificare se il percorso locale è archiviato in una variabile.Indicate whether the local path is stored in a variable. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.This property has the options listed in the following table.

ValoreValue DescriptionDescription
TrueTrue Il percorso di destinazione è archiviato in una variabile.The destination path is stored in a variable. Selezionando il valore viene visualizzata l'opzione dinamica LocalVariable.Selecting the value displays the dynamic option, LocalVariable.
FalseFalse Il percorso di destinazione è specificato in una gestione connessione file.The destination path is specified in a File connection manager. Selezionando il valore viene visualizzata l'opzione dinamica LocalPath.Selecting the value displays the dynamic option, LocalPath.

OperazioneOperation
Consente di selezionare l'operazione FTP da eseguire.Select the FTP operation to perform. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.This property has the options listed in the following table.

ValoreValue DescriptionDescription
Invia fileSend files Consente di inviare i file.Send files. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable, LocalPathRemoteVariable e RemotePath.Selecting this value displays the dynamic options, LocalVariable, LocalPathRemoteVariable and RemotePath.
Ricevi fileReceive files Consente di ricevere i file.Receive files. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable, LocalPathRemoteVariable e RemotePath.Selecting this value displays the dynamic options, LocalVariable, LocalPathRemoteVariable and RemotePath.
Crea directory localeCreate local directory Consente di creare una directory locale.Create a local directory. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable e LocalPath.Selecting this value displays the dynamic options, LocalVariable and LocalPath.
Crea directory remotaCreate remote directory Consente di creare una directory remota.Create a remote directory. Selezionando questo valore vengono visualizzate le opzioni dinamiche RemoteVariable e RemotelPath.Selecting this value displays the dynamic options, RemoteVariable and RemotelPath.
Rimuovi directory localeRemove local directory Consente di rimuovere una directory locale.Removes a local directory. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable e LocalPath.Selecting this value displays the dynamic options, LocalVariable and LocalPath.
Rimuovi directory remotaRemove remote directory Consente di rimuovere una directory remota.Remove a remote directory. Selezionando questo valore vengono visualizzate le opzioni dinamiche RemoteVariable e RemotePath.Selecting this value displays the dynamic options, RemoteVariable and RemotePath.
Elimina file localiDelete local files Consente di eliminare file locali.Delete local files. Selezionando questo valore vengono visualizzate le opzioni dinamiche LocalVariable e LocalPath.Selecting this value displays the dynamic options, LocalVariable and LocalPath.
Elimina file remotiDelete remote files Consente di eliminare file remoti.Delete remote files. Selezionando questo valore vengono visualizzate le opzioni dinamiche RemoteVariable e RemotePath.Selecting this value displays the dynamic options, RemoteVariable and RemotePath.

IsTransferASCIIIsTransferASCII
Consente di specificare se i file ricevuti e inviati dal server FTP remoto devono essere trasferiti in modalità ASCII.Indicate whether files transferred to and from the remote FTP server should be transferred in ASCII mode.

Opzioni dinamiche di IsRemotePathVariableIsRemotePathVariable Dynamic Options

IsRemotePathVariable = TrueIsRemotePathVariable = True

RemoteVariableRemoteVariable
Selezionare una variabile definita dall'utente esistente oppure fare clic su < nuova variabile... > per creare una variabile definita dall'utente.Select an existing user-defined variable, or click <New variable...> to create a user-defined variable.

Argomenti correlati: Variabili di Integration Services (SSIS), Aggiungi variabileRelated Topics: Integration Services (SSIS) Variables, Add Variable

IsRemotePathVariable = FalseIsRemotePathVariable = False

RemotePathRemotePath
Selezionare una gestione connessione FTP esistente o fare clic su < nuova connessione... > per creare una gestione connessione.Select an existing FTP connection manager, or click <New connection…> to create a connection manager.

Argomenti correlati: Gestione connessione FTP, Editor gestione connessione FTPRelated Topics: FTP Connection Manager, FTP Connection Manager Editor

Opzioni dinamiche di IsLocalPathVariableIsLocalPathVariable Dynamic Options

IsLocalPathVariable = TrueIsLocalPathVariable = True

LocalVariableLocalVariable
Selezionare una variabile definita dall'utente esistente oppure fare clic su < nuova variabile... > per creare una variabile.Select an existing user-defined variable, or click <New variable...> to create a variable.

Argomenti correlati: Variabili di Integration Services (SSIS), Aggiungi variabileRelated Topics: Integration Services (SSIS) Variables, Add Variable

IsLocalPathVariable = FalseIsLocalPathVariable = False

LocalPathLocalPath
Selezionare una gestione connessione File esistente oppure fare clic su < nuova connessione... > per creare una gestione connessione.Select an existing File connection manager, or click <New connection…> to create a connection manager.

Argomenti correlati: gestione connessione File FlatRelated Topics: Flat File Connection Manager

Vedere ancheSee Also

Attività di Integration Services Integration Services Tasks
Flusso di controlloControl Flow