Criando um gerenciador de conexões personalizado

Aplica-se a: SQL Server SSIS Integration Runtime em Azure Data Factory

Os passos que deve seguir para criar um gestor de conexões personalizado são semelhantes aos passos para criar qualquer outro objeto personalizado para Serviços de Integração:

• Crie uma nova classe que herde da classe base. Para um gestor de ligações, a classe base é ConnectionManagerBase.

• Aplique o atributo que identifica o tipo de objeto à classe. Para um gestor de conexões, o atributo é DtsConnectionAttribute.

• Sobrepõe-se à implementação dos métodos e propriedades da classe base. Para um gestor de conexões, estes incluem a ConnectionString propriedade e os AcquireConnection métodos e ReleaseConnection .

• Opcionalmente, desenvolva uma interface de utilizador personalizada. Para um gestor de conexões, isto requer uma classe que implemente a IDtsConnectionManagerUI interface.

Começar com um Gestor de Ligações personalizado

Criação de Projetos e Aulas

Como todos os gestores de ligações geridos derivam da ConnectionManagerBase classe base, o primeiro passo ao criar um gestor de conexões personalizado é criar um projeto de biblioteca de classes na sua linguagem de programação gerida preferida e criar uma classe que herde da classe base. Nesta classe derivada, irá sobrepor os métodos e propriedades da classe base para implementar a sua funcionalidade personalizada.

Na mesma solução, crie um projeto de biblioteca de segunda classe para a interface personalizada. Recomenda-se um assembly separado para a interface de utilizador para facilitar a implementação, pois permite atualizar e redistribuir o gestor de ligações ou a sua interface de utilizador de forma independente.

Configure ambos os projetos para assinarem os assemblies que serão gerados em tempo de compilação, usando um ficheiro forte de chave de nome.

Aplicação do atributo DtsConnection

Aplique o DtsConnectionAttribute atributo à classe que criou para a identificar como gestor de conexões. Este atributo fornece informação em tempo de design, como o nome, descrição e tipo de ligação do gestor de ligações. As ConnectionType propriedades e Description correspondem às colunas Tipo e Descrição exibidas na caixa de diálogo Add SSIS Gestor de Ligações, que é exibida ao configurar ligações para um pacote no SQL Server Data Tools (SSDT).

Use a UITypeName propriedade para ligar o gestor de ligação à sua interface personalizada. Para obter o token de chave pública necessário para esta propriedade, pode usar sn.exe -t para mostrar o token de chave pública do ficheiro par de chaves (.snk) que pretende usar para assinar a montagem da interface de utilizador.

<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  
{  
  . . .  
}  

Construção, Implementação e Depuração de um Gestor de Ligações Personalizado

Os passos para construir, implementar e depurar um gestor de conexões personalizado nos Serviços de Integração são semelhantes aos passos para outros tipos de objetos personalizados. Para mais informações, veja Construção, Implementação e Depuração de Objetos Personalizados.

Conteúdo relacionado

• Programar um Gestor de Ligações Personalizado
• Desenvolvimento de uma Interface de Utilizador para um Gestor de Ligações Personalizado