SSIS Package的调试有时是一个非常艰难的过程,由于SSIS 编译器给出的错误信息,可能并不完善,需要程序员根据错误信息抽丝拨茧,寻找错误的根源,进而解决问题。
第一部分:SSIS提供的调试工具
1,SSIS Package的 Control Flow 通过醒目的图标显示task的执行情况
在执行package的时候,如果一个Task上显示绿色的勾,表示task执行正常,如果显示的是红色的X,表示task执行异常。
通常SSIS Package调试的第一步就是寻找出错的Task,然后进入该task的data flow中查看报错的component。
在Task上显示错误信息,进入该task,发现Excel Source没有指定connection manager。
2,在package执行时,会出现一个progress显示执行的进度
如果错误,会在Progress中显示错误的信息
3,Data Viewer 查看从上游组件传递的数据
通过 点击蓝色的数据流线,Enable Data Viewer来查看数据。
4,设置breakpoint
选中Task,点击右键,选中Edit Breakpoint来设置断点,进行调试
5,package 事件,可以在事件中写入特殊的代码,当错误出现时,发送runtime的错误信息或将错误信息写入文档,方便程序员捕捉错误信息,提高debug的效率。
6,以上5种都是非常方便的调试工具,当然SSIS提供的辅助调试工具也有很多,各有用途,如果使用得当,将会使debug更有效率。
第二部分:示例
在使用scripte componet的一个package,出现一个错误信息 “object reference not set to an instance of an object”
说明在 scripte componet的C#代码中,并没有将对象设置为一个有效的实例。
DataTable dt; public override void PreExecute() { base.PreExecute(); IDTSConnectionManager100 cnManager = Connections.Connection; SqlConnection cnn = (SqlConnection)cnManager.AcquireConnection(null); SqlCommand cmd = cnn.CreateCommand(); cmd.CommandText = "select code,name from [dbo].[tbExcel]"; cmd.CommandType = CommandType.Text; cmd.CommandTimeout = 60000; dt = new DataTable("dt"); SqlDataAdapter sda = new SqlDataAdapter(cmd); sda.Fill(dt); }
从PreExecute函数中,可以看出,最有可能的错误原因是 cnManager 并没有获取到Package的Connection Manager
IDTSConnectionManager100 cnManager = Connections.Connection;
查看Script component的connection managers选项卡,已经设置了connection manager,那么错误的原因可能就是Name=Connection的Connection Manager的链接字符串有错误,导致无法连接到DB。
经验证,最终的结果跟推测一样,Connection Manager的链接字符串有错误,无法连接到DB,导致Script component执行失败。