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 CloseLog y Log.

• Las interfaces de usuario personalizadas para los proveedores de registro personalizados no se implementan 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 conexión 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 Description y DisplayName del atributo que corresponde a las columnas Name y Description 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, vea Generar, implementar y depurar objetos personalizados.

Vea también

Tasks

Codificar un proveedor de registro personalizado

Conceptos

Desarrollar una interfaz de usuario para un proveedor de registro personalizado