Partilhar via

  • Artigo

Criando um provedor de log personalizado

O ambiente de tempo de execução do Integration Services tem extensas capacidades de log. Um log permite que você capture eventos que ocorrem durante a execução de pacotes. O Integration Services inclui uma variedade de provedores de log que permitem a criação e o armazenamento de logs em vários formatos, tais como XML, texto, banco de dados ou no log de eventos do Windows. Se um desses provedores ou formatos de saída não forem adequados às suas necessidades, você pode criar um provedor de log personalizado.

As etapas envolvidas na criação de um provedor de log personalizado são semelhantes às etapas de criação de qualquer outro objeto personalizado para o Integration Services:

  • Crie uma classe nova herdada da classe base. Para um provedor de log, a classe base é LogProviderBase.

  • Aplique o atributo que identifica o tipo de objeto para a classe. Para um provedor de log, o atributo é DtsLogProviderAttribute.

  • Substitua a implementação dos métodos e propriedades da classe base. Para um provedor de log, eles incluem a propriedade ConfigString e os métodos OpenLog, Log e CloseLog.

  • As interfaces do usuário personalizadas para provedores de log personalizados não são implementadas no SQL Server Integration Services.

Para obter exemplos funcionais de provedores de log personalizados, consulte os exemplos do Integration Services no Codeplex.

Guia de Introdução com um Provedor de Log Personalizado

Criando Projetos e Classes

Como todos os provedores de log gerenciados derivam da classe base LogProviderBase, o primeiro passo para criar um provedor de log personalizado é criar um projeto de biblioteca de classes na linguagem de programação gerenciada de sua preferência e criar uma classe herdada da classe base. Nessa classe derivada, você substituirá os métodos e propriedades da classe base para implementar sua funcionalidade personalizada.

Configure o projeto para assinar o assembly que será gerado com um arquivo de chave de nome forte.

ObservaçãoObservação

Muitos provedores de log do Integration Services têm uma interface do usuário personalizada que implementa o IDtsLogProviderUI e substitui a caixa de texto Configuração na caixa de diálogo Configurar Logs de SSIS por uma lista suspensa filtrada com gerenciadores de conexões disponíveis. Porém, interfaces do usuário personalizadas para provedores de log personalizados não são implementadas no Integration Services.

Aplicando o atributo DtsLogProvider

Aplique o atributo DtsLogProviderAttribute à classe que você criou para identificá-lo como um provedor de log. Esse atributo fornece informações de tempo de design, como o nome e a descrição do provedor de log. As propriedades DisplayName e Description do atributo correspondem às colunas Nome e Descrição exibidas no editor Configurar Logs do SSIS, exibidas durante a configuração de logs para um pacote no Business Intelligence Development Studio.

Observação importanteImportante

A propriedade LogProviderType do atributo não é usada. Porém, você deve digitar um valor para ela ou o provedor de log personalizado não aparecerá na lista de provedores de log disponíveis.
ObservaçãoObservação

Como as interfaces do usuário personalizadas para provedores de log personalizados não são implementadas no Integration Services, especificar um valor para a propriedade UITypeName do DtsLogProviderAttribute não tem nenhum efeito.

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

Compilando, implantando e depurando um provedor de log personalizado

As etapas para compilar, implantar e depurar um provedor de log personalizado no Integration Services são muito semelhantes às etapas necessárias para outros tipos de objetos personalizados. Para obter mais informações, consulte Compilando, implantando e depurando objetos personalizados.

Ícone do Integration Services (pequeno) Fique atualizado com o Integration Services

Para obter os mais recentes downloads, artigos, exemplos e vídeos da Microsoft, bem como soluções selecionadas da comunidade, visite a página do Integration Services no MSDN ou TechNet:

Para receber uma notificação automática das atualizações, assine os feeds RSS disponíveis na página.