在脚本组件中引发事件

适用于:SQL Server Azure 数据工厂中的 SSIS Integration Runtime

事件提供向包含包报告错误、警告和其他信息(如任务进度或状态)的方式。 包为管理事件通知提供事件处理程序。 脚本组件可通过对 ScriptMain 类的 ComponentMetaData 属性调用方法来引发事件。 有关 Integration Services 包如何处理事件的详细信息,请参阅 Integration Services (SSIS) 事件处理程序

事件可以记录到包中已启用的任何日志提供程序中。 日志提供程序在数据存储区中存储有关事件的信息。 脚本组件还可以使用 Log 方法将信息记录到日志提供程序中而不引发事件。 有关如何使用 Log 方法的详细信息,请参阅以下内容。

为了引发事件,脚本任务将调用由 IDTSComponentMetaData100 属性公开的 ComponentMetaData 接口的以下方法之一:

事件 描述
FireCustomEvent 引发包中用户定义的自定义事件。
FireError 将错误情况通知包。
FireInformation 为用户提供信息。
FireProgress 将组件的进度通知包。
FireWarning 向包发出通知:组件处于有必要发出用户通知,但不是错误条件的状态。

下面是一个简单的引发错误事件的示例:

Dim myMetadata as IDTSComponentMetaData100

myMetaData = Me.ComponentMetaData

myMetaData.FireError(...)

另请参阅

Integration Services (SSIS) 事件处理程序
在包中添加事件处理程序