Integration Services (SSIS) 事件处理程序

在运行时，可执行文件（包以及 Foreach 循环容器、For 循环容器、序列容器和任务宿主容器）会引发事件。 例如，错误发生时会引发 OnError 事件。 可以为这些事件创建自定义事件处理程序，以扩展包的功能并使包在运行时更容易管理。 事件处理程序可以执行诸如下列任务：

• 当包或任务运行完成时清除临时数据存储。

• 在包运行前检索系统信息，以便评估资源可用性。

• 在引用表中的查找失败时刷新表中的数据。

• 当发生错误或警告时，或者当任务失败时，发送电子邮件。

如果事件没有事件处理程序，则将该事件提升到包中容器层次结构中的上一级容器。 如果此容器具有事件处理程序，则该事件处理程序当事件发生时运行。 如果没有，则将该事件提升到容器层次结构中的上一级容器。

以下关系图显示具有 For 循环容器的简单包，该容器包含一个执行 SQL 任务。

只有包具有事件处理程序，用于处理其 OnError 事件。 如果执行 SQL 任务运行时发生错误，包的 OnError 事件处理程序就会运行。 以下关系图显示导致包的 OnError 事件处理程序执行的调用序列。

事件处理程序是事件处理程序集的成员，所有容器都包含此事件处理程序集。 如果使用 SSIS 设计器创建包，就可以在 SSIS 设计器的**“包资源管理器”选项卡上的“事件处理程序”**文件夹中看到事件处理程序集的成员。

可以采用下列方法配置事件处理程序容器：

• 指定事件处理程序的名称和说明。

• 指示事件处理程序是否运行，事件处理程序失败时包是否失败，以及事件处理程序失败前可发生的错误数。

• 指定返回执行结果，而不是事件处理程序在运行时返回的实际执行结果。

• 指定事件处理程序的事务选项。

• 指定事件处理程序使用的日志记录模式。

事件处理程序内容

创建事件处理程序与生成包类似；事件处理程序具有多个任务和容器，这些任务和容器按照一定顺序组织成控制流，事件处理程序也可以包含多个数据流。 SSIS 设计器包含**“事件处理程序”**选项卡，用于创建自定义事件处理程序。 有关详细信息，请参阅 Integration Services (SSIS) 事件处理程序。

还可以采用编程方式创建事件处理程序。 有关详细信息，请参阅以编程方式处理事件。

运行时事件

下表列出 Integration Services 提供的事件处理程序，并介绍导致事件处理程序运行的运行时事件。

事件处理程序的配置

可以在 SQL Server Data Tools (SSDT) 的**“属性”**窗口中设置属性，或以编程方式设置属性。

有关如何在 SQL Server Data Tools (SSDT) 中设置这些属性的信息，请参阅设置任务或容器的属性。

有关如何以编程方式设置这些属性的信息，请参阅 DtsEventHandler。

相关任务

有关如何向包中添加事件处理程序的信息，请参阅在包中添加事件处理程序。

相关内容