Compartilhar via


Gerando eventos no componente Script

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

Os eventos fornecem um modo de relatar erros, avisos e outras informações, como o progresso ou status da tarefa, ao pacote que os contém. O pacote fornece manipuladores de eventos para gerenciar notificações de eventos. O componente Script pode gerar eventos chamando métodos na propriedade ComponentMetaData da classe ScriptMain. Para obter mais informações sobre como os pacotes do Integration Services manipulam eventos, confira Manipuladores de Eventos do SSIS (Integration Services).

Os eventos podem ser registrados em qualquer provedor de log que esteja habilitado no pacote. Provedores de logs armazenam informações sobre eventos em um repositório de dados. O componente Script também pode usar o método Log para registrar informações para um provedor de log sem gerar um evento. Para obter mais informações sobre como usar o método Log, consulte a seção seguinte.

Para gerar um evento, a tarefa Script chama um dos métodos seguintes da interface IDTSComponentMetaData100 expostos pela propriedade ComponentMetaData:

Evento Descrição
FireCustomEvent Gera um evento personalizado definido pelo usuário no pacote.
FireError Informa o pacote sobre uma condição de erro.
FireInformation Fornece informações ao usuário.
FireProgress Informa o pacote sobre o progresso do componente.
FireWarning Informa o pacote que o componente está em um estado que garante a notificação do usuário, mas não é uma condição de erro.

Eis um exemplo simples de geração de um evento de erro:

Dim myMetadata as IDTSComponentMetaData100

myMetaData = Me.ComponentMetaData

myMetaData.FireError(...)

Consulte Também

Manipuladores de eventos do SSIS (Integration Services)
Adicionar um manipulador de eventos a um pacote