Compartir a través de


Crear un proveedor de registro personalizado

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

El entorno en tiempo de ejecución de Integration Services incluye amplias funciones de registro. Un registro permite capturar eventos que se generan durante la ejecución del paquete. Integration Services incluye varios proveedores de registro que permiten crear registros y almacenarlos en diversos formatos como XML, texto, base de datos o en el registro de eventos de Windows. Si uno de estos proveedores o formatos de salida no se ajusta sus necesidades, puede crear un proveedor de registro personalizado.

Los pasos necesarios para crear un proveedor de registro personalizado son similares a los pasos para crear cualquier otro objeto personalizado para Integration Services:

  • Cree una clase nueva que herede de la clase base. Para un proveedor de registro, la clase base es LogProviderBase.

  • Aplique el atributo que identifica el tipo de objeto para la clase. Para un proveedor de registro, el atributo es DtsLogProviderAttribute.

  • Invalide la implementación de los métodos y las propiedades de la clase base. Para un proveedor de registro, estos incluyen la propiedad ConfigString y OpenLog, los métodos Log y CloseLog.

  • Las interfaces de usuario personalizadas para los proveedores de registro personalizados no están implementadas en SQL Server Integration Services.

Introducción a un proveedor de registro personalizado

Crear proyectos y clases

Dado que todos los proveedores de registro administrados se derivan de la clase base LogProviderBase, el primer paso para crear un proveedor de registro 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.

Configure el proyecto para firmar el ensamblado que se generará con un archivo de claves del nombre seguro.

Nota:

Muchos proveedores de registro de Integration Services tienen una interfaz de usuario personalizada que implementa IDtsLogProviderUI y reemplaza el cuadro de texto Configuración en el cuadro de diálogo Configurar registros de SSIS por una lista desplegable filtrada de administradores de conexiones disponibles. Sin embargo, las interfaces de usuario personalizadas para los proveedores de registro personalizados no se implementan en Integration Services.

Aplicar el atributo DtsLogProvider

Aplique el atributo DtsLogProviderAttribute a la clase que ha creado para identificarlo como un proveedor de registro. Este atributo proporciona información en tiempo de diseño, como el nombre y la descripción del proveedor de registro. Las propiedades DisplayName y Description del atributo corresponden a las columnas Nombre y Descripción que se muestran en el editor Configurar registros de SSIS, que se muestra al configurar el registro para un paquete en SQL Server Data Tools (SSDT).

Importante

La propiedad LogProviderType del atributo no se usa. Sin embargo, debe especificar un valor para la propiedad o el proveedor de registro personalizado no aparecerá en la lista de proveedores de registro disponibles.

Nota:

Desde que las interfaces de usuario personalizadas para los proveedores de registro personalizados no se implementa en Integration Services, especificar un valor para la propiedad UITypeName de DtsLogProviderAttribute no tiene ningún efecto.

<DtsLogProvider(DisplayName:="MyLogProvider", Description:="A simple log provider.", LogProviderType:="Custom")> _  
Public Class MyLogProvider  
     Inherits LogProviderBase  
    ' TODO: Override the base class methods.  
End Class  
[DtsLogProvider(DisplayName="MyLogProvider", Description="A simple log provider.", LogProviderType="Custom")]  
public class MyLogProvider : LogProviderBase  
{  
    // TODO: Override the base class methods.  
}  

Generar, implementar y depurar un proveedor de registro personalizado

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

Consulte también

Codificar un proveedor de registro personalizado
Desarrollar una interfaz de usuario para un proveedor de registro personalizado