SSIS内置的调试工具是非常完备的,主要是设置断点和查看变量值,这是在Package的设计阶段可以使用的工具,在Package部署到服务器之后,用户还可以使用事件处理程序以实现Package出错的自我修复,使用日志记录等来监控Package的运行状态,以记录Package出现故障时的现场信息,为后续修复Package的错误提供最原始和有效的信息。在数据流Task中,可以通过重定向错误行把错误保存起来,便于后续的调试和故障排除。
一,设置断点
断点是调试Package最常用的工具,选中Task,右击选择“Edit Breakpoint”,打开断点编辑器,为该Task组件设置断点。断点的触发条件是Task接收到特定的事件,用户可以为一个Task设置多种中断条件的断点,常用的中断条件是:
- Bread when the container receives the OnPreExecute event
- Bread when the container receives the OnPostExecute event
- Bread when the container receives the OnError event
设置断点的向导如下图所示,不仅可以选择中断条件(Break Condition),还是设置条件命中的次数和类型:
在断点处,用于可以通过进行Step Into、Step Over和Step Out操作,以便查看Package的运行状态。
二,查看变量值
在Packag运行到断点时,用户可以通过Local窗口来窗口Package中所有变量和属性的值,
Local窗口中的变量是Package中的所有变量,包括用户自定义的变量和系统变量。在调试Package时,变量太多,以至于开发工程师需要浪费时间去查找比较关键的变量。一般情况下,影响Package运行结果的是很少的几个变量,用户比较关注的也是这几个变量,这是,用户可以通过Watch窗口,输入特定的变量,重点监控这几个变量的当前值,以确认Package运行的状态:
三,事件处理程序
每一个Task和容器都会在运行时触发事件,例如,OnError事件等,事件处理程序是在特定事件被触发时,SSIS自动调用的处理程序,事件处理程序会捕获和处理相关事件。在设计Package时,开发工程师预测可能出现的异常,当异常发生时,Package自动调用事件处理程序来发送邮件通知相关人员及时修复可能存在的异常,或者重新执行Package等,以实现Package的自我修复。
事件处理程序捕获事件,而事件是由Task触发的,常用的事件是
- OnError事件:只要发生错误都会触发该事件;
- OnPostExecute事件:仅在Task或容器执行完成之后触发该事件;
- OnPreExecute事件:仅在Task或容器执行之前触发该事件;
事件处理程序继承其子Task的相关事件,这意味着如果存在一个容器,并且该容器有一个针对OnError事件定义的事件处理程序,那么当该容器的一个子Task发生错误时,将会触发此容器的事件处理程序。该过程被称作“冒泡”事件,或者从子Task到容器的旅行。*别的可执行文件是Package本身,因此,如果在Package级别定义了一个事件处理程序,那么每当事件发生时,都会触发Package级别的事件处理程序。
四,日志记录
通常情况下,使用项目部署模型把Package部署到SSIS服务上,使用SSISDB数据库来保存Package运行的日志。如果要修改日志记录的级别,那么需要修改SSISDB的默认设置。
在Integration Services Catalogs目录下,点击SSISDB,配置Server-wide的默认日志级别。
五,错误输出
在数据流中,错误行都是通过使用Error Output来配置的,这些属性高数数据流组件,当针对某一行的操作失败(出错或截断)时应该怎么做。
对错误或截断的处理程序有三种:
- 组件失败(Fail Component):当针对某一列选择了“组件失败”,并且产生了错误时,数据流将停止运行并失败,同时触发任何针对数据流任务的OnError事件。
- 重定向行(Redirect Row):当任何被标记为重定向的列中任何一行产生错误,整个行都将被发送到红色的错误路径输出,但是,数据流任务不会失败。如果没有使用红色的错误路径,那么该行将从数据流中丢弃。
- 忽略失败(Ignore Failure):如果错误发生在源或转换中,那么错误列的值会被设置为NULL。如果是截断错误,那么只会向下游发送截断之后的值。当对目标进行处理时,某一列的忽略错误会导致忽略整个数据行,而不是忽略错误列。
用户可以把错误行重定向,保存到特定的数据结构中,以保存错误的数据,然后分析数据,对Package进行故障排除。