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