Crear un administrador de conexiones personalizado

Artículo
05/23/2023

Se aplica a: SQL Server SSIS Integration Runtime en Azure Data Factory

Los pasos que debe seguir para crear un administrador de conexiones personalizado son similares a los pasos necesarios para crear cualquier otro objeto personalizado para Integration Services:

Cree una clase nueva que herede de la clase base. Para un administrador de conexiones, la clase base es ConnectionManagerBase.
Aplique el atributo que identifica el tipo de objeto para la clase. Para un administrador de conexiones, el atributo es DtsConnectionAttribute.
Invalide la implementación de los métodos y las propiedades de la clase base. Para un administrador de conexiones, estos incluyen la propiedad ConnectionString y los métodos AcquireConnection y ReleaseConnection.
Si lo desea, desarrolle una interfaz de usuario personalizada. Para un administrador de conexiones, esto requiere una clase que implemente la interfaz IDtsConnectionManagerUI.

Nota:

Muchas de las tareas, orígenes y destinos que se han incluido en Integration Services se usan únicamente con tipos específicos de administradores de conexiones integrados. Por consiguiente, estos ejemplos no se pueden probar con las tareas y componentes integrados.

Introducción a un administrador de conexiones personalizado

Crear proyectos y clases

Dado que todos los administradores de conexiones administrados se derivan de la clase base ConnectionManagerBase, el primer paso para crear un administrador de conexiones personalizado consiste en crear un proyecto de bibliotecas de clases en el lenguaje de programación administrado que prefiera y, a continuación, crear una clase que herede de la clase base. En esta clase derivada se invalidarán los métodos y las propiedades de la clase base para implementar la funcionalidad personalizada.

En la misma solución, cree un segundo proyecto de bibliotecas de clases para la interfaz de usuario personalizada. Se recomienda usar un ensamblado independiente para la interfaz de usuario a fin de facilitar la implementación, ya que le permite actualizar y volver a implementar la tarea o su interfaz de usuario de forma independiente.

Configure ambos proyectos para firmar los ensamblados que se generarán en tiempo de compilación mediante un archivo de clave de nombre seguro.

Aplicar el atributo DtsConnection

Aplique el atributo DtsConnectionAttribute a la clase que ha creado para identificarlo como un administrador de conexiones. Este atributo proporciona información en tiempo de diseño, como el nombre, la descripción y el tipo de conexión del administrador de conexiones. Las propiedades ConnectionType y Description corresponden a las columnas Tipo y Descripción que se muestran en el cuadro de diálogo Agregar administrador de conexiones SSIS, que aparece al configurar las conexiones para un paquete en SQL Server Data Tools (SSDT).

Use la propiedad UITypeName para vincular el administrador de conexiones a su interfaz de usuario personalizada. Para obtener el token de clave pública necesario para esta propiedad, puede usar sn.exe -t con el fin de mostrar el token de clave pública del archivo de pares de claves (.snk) que quiere usar para firmar el ensamblado de la interfaz de usuario.

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

Generar, implementar y depurar un administrador de conexiones personalizado

Los pasos para generar, implementar y depurar un administrador de conexiones personalizado en Integration Services son similares a los pasos necesarios en otros tipos de objetos personalizados. Para obtener más información, consulte Generar, implementar y depurar objetos personalizados.

Consulte también

Codificar un administrador de conexiones personalizado
Desarrollar una interfaz de usuario para un administrador de conexiones personalizado

Compartir vía