Esempio di gestione connessione personalizzata SQL Server

Articolo
12/15/2008

Data aggiornamento: 14 aprile 2006

Nell'esempio di gestione connessione personalizzata a SQL Server viene illustrato come creare una gestione connessione personalizzata, Sql Connection Manager, e la relativa interfaccia utente. Questo esempio non è supportato nei sistemi operativi basati su processori Itanium.

Per ulteriori informazioni sulla creazione di una gestione connessione personalizzata, vedere Creating a Custom Connection Manager. Per informazioni generali sull'utilizzo delle gestioni connessioni in Integration Services, vedere Connessioni in Integration Services e Gestioni connessioni.

La gestione connessione personalizzata esegue la connessione a un'istanza disponibile di Microsoft SQL Server tramite il provider di dati .NET Framework per SqlClient e restituisce un oggetto SqlConnection aperto dal proprio metodo AcquireConnection. Quando si crea una nuova istanza di Sql Connection Manager in un pacchetto, l'interfaccia utente personalizzata chiede il nome del server e del database. L'esempio esegue la connessione solo a un'istanza predefinita di SQL Server e utilizza solo l'autenticazione di Windows.

Con questo esempio di codice vengono implementate le funzionalità seguenti:

Overriding della classe ConnectionManagerBase.
Supporto della persistenza.

Importante:
Gli esempi vengono offerti esclusivamente a scopo didattico. Non sono progettati per l'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non fornisce servizi di supporto tecnico per questi esempi.

Esecuzione dell'esempio

Se non sono necessarie informazioni sulle procedure per l'individuazione, la generazione e l'installazione degli esempi di codice, è possibile passare direttamente alla sezione Test dell'esempio per informazioni sulla configurazione e l'esecuzione dell'esempio di codice.

Prerequisiti

Per l'esecuzione di questo esempio è necessario che siano installati i componenti seguenti.

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

Percorso

Se l'esempio di codice è stato installato nel percorso predefinito, si trova nella directory seguente:

C:\Programmi\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\SqlConnectionManager Sample

La versione C# dell'esempio di codice si trova nella directory SqlConnMgrCS, mentre la versione Visual Basic si trova nella directory SqlConnMgrVB.

Per ulteriori informazioni sul processo in due fasi necessario per l'installazione degli esempi, vedere Installazione degli esempi. Per ottenere la versione più recente degli esempi, inclusi nuovi esempi resi disponibili dopo il rilascio di SQL Server 2005, vedere Esempi e database di esempio di SQL Server 2005 (aprile 2006).

Generazione dell'esempio

Se non è stato ancora generato un file di chiave con nome sicuro nella cartella Samples, attenersi alla procedura seguente per generarlo. Nella scheda Firma della finestra di dialogo Proprietà progetto sono configurati progetti di esempio per la firma di assembly durante la generazione con questo file di chiave.

Per generare un file di chiave con nome sicuro

Per aprire il prompt dei comandi di Microsoft Visual Studio 2005, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2005, Visual Studio Tools e quindi fare clic su Prompt dei comandi di Visual Studio 2005.

-oppure-

Per aprire il prompt dei comandi di Microsoft .NET Framework, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK v2.0 e quindi fare clic su SDK Command Prompt.
Al prompt dei comandi mediante il comando CD (change directory) passare dalla directory corrente della finestra del prompt dei comandi alla cartella Samples. Il file di chiave creato in questa cartella verrà utilizzato da tutti gli esempi di codice di SQL Server 2005.

[!NOTA] Per determinare la cartella in cui si trovano gli esempi, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2005, Documentazione ed esercitazioni e quindi Directory esempi. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <system_drive>:\Programmi\Microsoft SQL Server\90\Samples.

Al prompt dei comandi digitare il comando seguente per generare il file di chiave:

sn -k SampleKey.snk

Importante:
Per ulteriori informazioni sulla coppia di chiavi con nome sicuro, vedere l'argomento relativo ai nomi sicuri e alla protezione in .NET Framework nel centro per sviluppatori di .NET su MSDN (informazioni in lingua inglese).

Il token di chiave pubblica del file di chiave sarà necessario in un passaggio successivo. Per ottenere il token di chiave pubblica, estrarre innanzitutto la chiave pubblica dal file di chiave eseguendo il comando seguente al prompt dei comandi:
```
sn -p SampleKey.snk SampleKeyPublic.snk
```
A questo punto visualizzare il token di chiave pubblica dal nuovo file eseguendo il comando seguente al prompt dei comandi:
```
sn -t SampleKeyPublic.snk
```
Copiare il token di chiave pubblica negli Appunti o salvarlo per un utilizzo futuro.

Per generare l'esempio in Microsoft Visual Studio 2005

Scegliere Apri dal menu File e quindi Progetto per aprire il file della soluzione SqlConnMgrVB.sln o SqlConnMgrCS.sln.
In Esplora soluzioni selezionare il progetto SqlConnMgrVB o SqlConnMgrCS.
Individuare l'attributo DtsConnection prima della dichiarazione di classe nel file SqlConnMgrCS.cs o SqlConnMgrVB.vb e sostituire il valore alfanumerico del token di chiave pubblica nella proprietà UITypeName dell'attributo con il token di chiave pubblica ottenuto in precedenza dal file di chiave.
Scegliere Genera soluzione dal menu Genera.

Installazione dell'esempio

Questo esempio è disponibile in Visual Basic e C#. Per distinguere gli assembly delle due versioni dell'esempio, al nome degli assembly di output sono stati aggiunti i suffissi CS e VB. Dopo aver generato il componente, eseguire la procedura seguente per aggiungerlo come gestione connessione in un pacchetto di Business Intelligence Development Studio.

Per copiare il componente nella cartella Connections

Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.
Copiare gli assembly (SqlConnMgrCS.dll e SqlConnMgrUICS.dll oppure SqlConnMgrVB.dll e SqlConnMgrUIVB.dll) nella cartella Connections in %system%\Program Files\Microsoft SQL Server\90\DTS.

Per installare il componente nella cache di assembly globale (CAG) trascinando gli assembly

Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.
Trascinare gli assembly dalla cartella Connections alla cartella in cui si trova la cache di assembly globale (CAG), nel percorso %system%\assembly.

Per installare il componente nella cache di assembly globale (CAG) tramite gacutil.exe

Aprire la finestra del prompt dei comandi.

Digitare i comandi seguenti per installare la versione C# del componente e l'interfaccia utente nella cache di assembly globale (CAG):

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrCS.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrUICS.dll"

-oppure-

Digitare i comandi seguenti per installare la versione Visual Basic del componente e l'interfaccia utente nella cache di assembly globale (CAG):

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrUIVB.dll"

Test dell'esempio

A questo punto è possibile testare la gestione connessione personalizzata in un pacchetto.

Per utilizzare la gestione connessione di esempio in un pacchetto

Nell'area delle gestioni connessioni di Progettazione SSIS fare clic con il pulsante destro del mouse e scegliere Nuova connessione, quindi scegliere SQL nell'elenco dei tipi di connessione disponibili. Fare clic su OK.
Modificare la nuova gestione connessione. In Editor gestione connessione Sql specificare il nome di un'istanza disponibile del Motore di database di SQL Server e di un database disponibile.

Cronologia modifiche

Versione	Cronologia
14 aprile 2006	Contenuto modificato: Correzione dei nomi dei file e delle cartelle.

Condividi tramite