Crear un proveedor de registro personalizado

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 DisplayName propiedades y Description del atributo corresponden al nombre y Description las columnas que se muestran en el editor Configurar registros de SSIS, que se muestra al configurar el registro de 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.

Mantenerse al día con Integration Services
Para obtener las descargas, artículos, ejemplos y vídeos más recientes de Microsoft, así como soluciones seleccionadas de la comunidad, visite la página Integration Services en MSDN:

Visite la página de Integration Services en MSDN

Para recibir notificaciones automáticas de estas actualizaciones, suscríbase a las fuentes RSS disponibles en la página.

Consulte también

Codificación de un proveedorde registro personalizado desarrollando una interfaz de usuario para un proveedor de registro personalizado