gestione connessione fileFile Connection Manager

Una gestione connessione file consente a un pacchetto di fare riferimento a un file o a una cartella esistente oppure di creare un file o una cartella in fase di esecuzione.A File connection manager enables a package to reference an existing file or folder, or to create a file or folder at run time. Ad esempio, è possibile fare riferimento a un file di Excel.For example, you can reference an Excel file. Le informazioni presenti nei file vengono utilizzate da alcuni componenti di MicrosoftMicrosoft SQL ServerSQL Server Integration ServicesIntegration Services per effettuare le operazioni.Certain components in MicrosoftMicrosoft SQL ServerSQL Server Integration ServicesIntegration Services use information in files to perform their work. L'attività Esegui SQL può ad esempio fare riferimento a un file che contiene le istruzioni SQL eseguite dall'attività.For example, an Execute SQL task can reference a file that contains the SQL statements that the task executes. In altri componenti le operazioni vengono effettuate nei file.Other components perform operations on files. Ad esempio, tramite l'attività File System è possibile fare riferimento a un file per copiarlo in una nuova posizione.For example, the File System task can reference a file to copy it to a new location.

Tipi di utilizzo per la gestione connessione fileUsage Types of the File Connection Manager

Tramite la proprietà FileUsageType della gestione connessione file viene specificata la modalità di utilizzo della connessione file.The FileUsageType property of the File connection manager specifies how the file connection is used. La gestione connessione file può creare un file o una cartella oppure utilizzare un file o una cartella esistente.The File connection manager can create a file, create a folder, use an existing file, or use an existing folder.

Nella tabella seguente vengono elencati i possibili valori di FileUsageType.The following table lists the values of FileUsageType.

ValoreValue DescrizioneDescription
00 La gestione connessione file utilizza un file esistente.File connection manager uses an existing file.
11 La gestione connessione file crea un file.File connection manager creates a file.
22 La gestione connessione file utilizza una cartella esistente.File connection manager uses an existing folder.
33 La gestione connessione file crea una cartella.File connection manager creates a folder.

Connessioni a più file o cartelleMultiple File or Folder Connections

La gestione connessione file può fare riferimento solo a un file o a una cartella.The File connection manager can reference only one file or folder. Per fare riferimento a più file o cartelle, al posto di una gestione connessione file utilizzare una gestione connessione per più file.To reference multiple files or folders, use a Multiple Files connection manager instead of a File connection manager. Per altre informazioni, vedere Multiple Files Connection Manager.For more information, see Multiple Files Connection Manager.

Configurazione della gestione connessione fileConfiguration of the File Connection Manager

Quando si aggiunge una gestione connessione file a un pacchetto, Integration ServicesIntegration Services crea una gestione connessione che in fase di esecuzione verrà risolta in una connessione file, imposta le proprietà della connessione file e la aggiunge alla raccolta Connections del pacchetto.When you add a File connection manager to a package, Integration ServicesIntegration Services creates a connection manager that will resolve to a File connection at run time, sets the File connection properties, and adds the File connection to the Connections collection of the package.

La proprietà ConnectionManagerType della gestione connessione viene impostata su FILE.The ConnectionManagerType property of the connection manager is set to FILE.

Per configurare una gestione connessione file, procedere nel modo seguente:You can configure a File connection manager in the following ways:

  • Specificare il tipo di utilizzo.Specify the usage type.

  • Specificare un file o una cartella.Specify a file or folder.

    È possibile impostare la proprietà ConnectionString per la gestione connessione file specificando un'espressione nella finestra Proprietà di SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).You can set the ConnectionString property for the File connection manager by specifying an expression in the Properties window of SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT). Tuttavia, per evitare un errore di convalida quando si usa un'espressione per specificare il file o la cartella, aggiungere il percorso di un file o di una cartella in Editor gestione connessione fileper File/Cartella.However, to avoid a validation error when you use an expression to specify the file or folder, in the File Connection Manager Editor, for File/Folder, add a file or folder path.

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

    Per altre informazioni sulle proprietà che è possibile impostare in Progettazione SSISSSIS , vedere Editor gestione connessione file.For more information about the properties that you can set in SSISSSIS Designer, see File Connection Manager Editor.

    Per informazioni sulla configurazione di una gestione connessione a livello di programmazione, vedere l'articolo relativo a ConnectionManager e Aggiunta di connessioni a livello di programmazione.For information about configuring a connection manager programmatically, see ConnectionManager and Adding Connections Programmatically.

Editor gestione connessione fileFile Connection Manager Editor

Utilizzare la finestra di dialogo Editor gestione connessione file per specificare le proprietà utilizzate per la connessione a un file o a una cartella.Use the File Connection Manager Editor dialog box to specify the properties used to connect to a file or a folder.

Nota

È possibile impostare la proprietà ConnectionString per la gestione connessione file specificando un'espressione nella finestra Proprietà di SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).You can set the ConnectionString property for the File connection manager by specifying an expression in the Properties window of SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT). Tuttavia, per evitare un errore di convalida quando si usa un'espressione per specificare il file o la cartella, aggiungere il percorso di un file o di una cartella in Editor gestione connessione fileper File/Cartella.However, to avoid a validation error when you use an expression to specify the file or folder, in the File Connection Manager Editor, for File/Folder, add a file or folder path.

Per ulteriori informazioni sulla gestione connessione file, vedere File Connection Manager.To learn more about the File connection manager, see File Connection Manager.

OpzioniOptions

Tipo di utilizzoUsage Type
Consente di specificare se Gestione connessione file flat deve connettersi a un file o a una cartella esistente o creare un nuovo file o cartella.Specify whether the File Connection Manager connects to an existing file or folder or creates a new file or folder.

ValoreValue DescriptionDescription
Creazione fileCreate file Consente di creare un nuovo file in fase di esecuzione.Create a new file at run time.
File esistenteExisting file Consente di utilizzare un file esistente.Use an existing file.
Creazione cartellaCreate folder Consente di creare una nuova cartella in fase di esecuzione.Create a new folder at run time.
Cartella esistenteExisting folder Consente di utilizzare una cartella esistente.Use an existing folder.

File/CartellaFile / Folder
Se si sceglie File, specificare il file da usare.If File, specify the file to use.

Se si sceglie Cartella, specificare la cartella da utilizzare.If Folder, specify the folder to use.

SfogliaBrowse
Selezionare il file o la cartella usando la finestra di dialogo Seleziona file o Sfoglia cartella .Select the file or folder by using the Select File or Browse for Folder dialog box.