Creazione di una gestione connessione personalizzata

Articolo
05/23/2023

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

I passaggi che è necessario effettuare per creare una gestione connessione personalizzata sono simili ai passaggi necessari per la creazione di qualsiasi altro oggetto personalizzato per Integration Services:

Creare una nuova classe che eredita dalla classe di base. Per una gestione connessione, la classe di base è ConnectionManagerBase.
Applicare alla classe l'attributo che identifica il tipo di oggetto. Per una gestione connessione, l'attributo è DtsConnectionAttribute.
Eseguire l'override dell'implementazione dei metodi e delle proprietà della classe di base. Per una gestione connessione, questi includono la proprietà ConnectionString e i metodi AcquireConnection e ReleaseConnection.
Se si desidera, sviluppare un'interfaccia utente personalizzata. Per una gestione connessione, è richiesta una classe tramite cui venga implementata l'interfaccia IDtsConnectionManagerUI.

Nota

La maggior parte delle attività, delle origini e delle destinazioni incluse in Integration Services funziona solo con tipi specifici di gestioni connessioni predefinite. Questi esempi, pertanto, non possono essere testati con le attività e i componenti predefiniti.

Introduzione alle gestioni connessioni personalizzate

Creazione di progetti e classi

Poiché tutte le gestioni connessioni derivano dalla classe di base ConnectionManagerBase, il primo passaggio da completare quando si crea una gestione connessione personalizzata consiste nel creare un progetto di libreria di classi nel linguaggio di programmazione gestito preferito e creare una classe che eredita dalla classe di base. In questa classe derivata si eseguirà l'override dei metodi e delle proprietà della classe di base per implementare la funzionalità personalizzata.

Nella stessa soluzione creare un secondo progetto di libreria di classi per l'interfaccia utente personalizzata. Per semplificare lo sviluppo, si consiglia di utilizzare un assembly distinto per l'interfaccia utente, perché in questo modo è possibile e ridistribuire la gestione connessione o la relativa interfaccia utente in modo indipendente.

Configurare entrambi i progetti per firmare gli assembly che verranno generati durante la compilazione utilizzando un file di chiave con nome sicuro.

Applicazione dell'attributo DtsConnection

Applicare l'attributo DtsConnectionAttribute alla classe creata per identificarla come gestione connessione. Questo attributo fornisce informazioni in fase di progettazione, ad esempio il nome, la descrizione e il tipo di connessione della gestione connessione. Le proprietà ConnectionType e Description corrispondono alle colonne Tipo e Descrizione della finestra di dialogo Aggiungi gestione connessione SSIS, visualizzata quando si configurano le connessioni per un pacchetto in SQL Server Data Tools (SSDT).

Utilizzare la proprietà UITypeName per collegare la gestione connessione alla relativa interfaccia utente personalizzata. Per ottenere il token di chiave pubblica richiesto per questa proprietà, è possibile usare sn.exe -t per visualizzare il token di chiave pubblica dal file della coppia di chiavi (con estensione snk) che si intende usare per firmare l'assembly dell'interfaccia utente.

<DtsConnection(ConnectionType:="SQLVB", _  
  DisplayName:="SqlConnectionManager (VB)", _  
  Description:="Connection manager for Sql Server", _  
  UITypeName:="SqlConnMgrUIVB.SqlConnMgrUIVB,SqlConnMgrUIVB,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")> _  
Public Class SqlConnMgrVB  
  Inherits ConnectionManagerBase  
  . . .  
End Class

[DtsConnection(ConnectionType = "SQLCS",  
  DisplayName = "SqlConnectionManager (CS)",  
  Description = "Connection manager for Sql Server",  
  UITypeName = "SqlConnMgrUICS.SqlConnMgrUICS,SqlConnMgrUICS,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")]  
public class SqlConnMgrCS :  
ConnectionManagerBase  
{  
  . . .  
}

Compilazione, distribuzione e debug di una gestione connessione personalizzata

I passaggi per la compilazione, la distribuzione e il debug di una gestione connessione personalizzata in Integration Services sono simili a quelli richiesti per altri tipi di oggetti personalizzati. Per altre informazioni, vedere Compilazione, distribuzione e debug di oggetti personalizzati.

Vedere anche

Scrittura del codice di una gestione connessione personalizzata
Sviluppo di un'interfaccia utente per una gestione connessione personalizzata

Share via