Connessione a origini dati nel componente script

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

Una gestione connessione è un'unità pratica che incapsula e archivia le informazioni necessarie per la connessione a un'origine dati di un determinato tipo. Per altre informazioni, vedere Connessioni di Integration Services (SSIS).

È possibile rendere disponibili le gestioni connessioni esistenti per l'accesso da parte dello script personalizzato nel componente di origine o destinazione facendo clic sui pulsanti Aggiungi e Rimuovi nella pagina Gestioni connessioni dell'Editor trasformazione Script. È tuttavia necessario scrivere codice personalizzato per caricare o salvare i dati e possibilmente per aprire e chiudere la connessione all'origine dati. Per altre informazioni sulla pagina Gestioni connessioni dell'Editor trasformazione Script, vedere Configurazione del componente script nell'editor corrispondente ed Editor trasformazione Script (pagina Gestioni connessioni).

Il componente script crea una classe di raccolta Connections nell'elemento di progetto ComponentWrapper che contiene una funzione di accesso fortemente tipizzata per ogni gestione connessione che ha lo stesso nome della gestione connessione. Questa raccolta viene esposta tramite la proprietà Connections della classe ScriptMain. La proprietà della funzione di accesso restituisce un riferimento alla gestione connessione come istanza di IDTSConnectionManager100. Ad esempio, se è stata aggiunta una gestione connessione denominata MyADONETConnection nella pagina Gestioni connessioni della finestra di dialogo, è possibile ottenere un riferimento ad essa nello script tramite il codice seguente:

Dim myADONETConnectionManager As IDTSConnectionManager100 = _

Me.Connections.MyADONETConnection

Nota

È necessario conoscere il tipo di connessione restituito dalla gestione connessione prima di chiamare AcquireConnection. Poiché l'oggetto Option Strict dell'attività Script è abilitato, è necessario eseguire il cast della connessione, che viene restituita come tipo Object, nel tipo di connessione appropriato prima dell'uso.

Chiamare quindi il metodo AcquireConnection della gestione connessione specifica per ottenere la connessione sottostante o le informazioni necessarie per connettersi all'origine dati. Ad esempio, per ottenere un riferimento a System.Data.SqlConnection incluso in una gestione connessione ADO.NET, usare il codice seguente:

Dim myADOConnection As SqlConnection = _

CType(MyADONETConnectionManager.AcquireConnection(Nothing), SqlConnection)

Viceversa, la stessa chiamata a una gestione connessione file flat restituisce solo il percorso e il nome di file dell'origine dati del file.

Dim myFlatFile As String = _

CType(MyFlatFileConnectionManager.AcquireConnection(Nothing), String)

È quindi necessario specificare questo percorso e questo nome di file in un oggetto System.IO.StreamReader o Streamwriter per leggere o scrivere i dati nel file flat.

Importante

Quando si scrive codice gestito in un componente script, non è possibile chiamare il metodo AcquireConnection delle gestioni connessioni che restituiscono oggetti non gestiti, ad esempio la gestione connessione OLE DB e la gestione connessione Excel. È tuttavia possibile leggere la proprietà ConnectionString di queste gestioni connessioni e connettersi direttamente all'origine dati nel codice usando la stringa di connessione di un oggetto connection OLEDB dallo spazio dei nomi System.Data.OleDb.

Se è necessario chiamare il metodo AcquireConnection di una gestione connessione che restituisce un oggetto non gestito, usare una gestione connessione ADO.NET. Quando si configura la gestione connessione ADO.NET per l'utilizzo di un provider OLE DB, la connessione viene eseguita tramite il provider di dati .NET Framework per OLE DB. In questo caso il metodo AcquireConnection restituisce un oggetto System.Data.OleDb.OleDbConnection invece di un oggetto non gestito. Per configurare una gestione connessione ADO.NET per l'utilizzo con un'origine dati Excel, selezionare il provider Microsoft OLE DB per Jet, specificare una cartella di lavoro di Excel, quindi immettere Excel 8.0 (per Excel 97 e versioni successive) come valore di Proprietà estese nella pagina Tutte della finestra di dialogo Gestione connessione.

Per altre informazioni sull'uso delle gestioni connessioni con il componente script, vedere Creazione di un'origine con il componente script e Creazione di una destinazione con il componente script.

Vedi anche

Connessioni in Integration Services (SSIS)
Creare gestioni connessioni