一次SSIS Package的调试经历

亦凉 2022-06-17 11:28 241阅读 0赞

SSIS Package的调试有时是一个非常艰难的过程，由于SSIS 编译器给出的错误信息，可能并不完善，需要程序员根据错误信息抽丝拨茧，寻找错误的根源，进而解决问题。

第一部分：SSIS提供的调试工具

1，SSIS Package的 Control Flow 通过醒目的图标显示task的执行情况

在执行package的时候，如果一个Task上显示绿色的勾，表示task执行正常，如果显示的是红色的X，表示task执行异常。

通常SSIS Package调试的第一步就是寻找出错的Task，然后进入该task的data flow中查看报错的component。

![261302392874125.jpg][]

在Task上显示错误信息，进入该task，发现Excel Source没有指定connection manager。

![261303278038947.jpg][]

![261304561932684.jpg][]

2，在package执行时，会出现一个progress显示执行的进度

如果错误，会在Progress中显示错误的信息

![261301358499678.jpg][]

3，Data Viewer 查看从上游组件传递的数据

通过 点击蓝色的数据流线，Enable Data Viewer来查看数据。

![261307109126141.jpg][]

4，设置breakpoint

选中Task，点击右键，选中Edit Breakpoint来设置断点，进行调试

![261309091315459.jpg][]

5，package 事件，可以在事件中写入特殊的代码，当错误出现时，发送runtime的错误信息或将错误信息写入文档，方便程序员捕捉错误信息，提高debug的效率。

![261313364908770.jpg][]

6，以上5种都是非常方便的调试工具，当然SSIS提供的辅助调试工具也有很多，各有用途，如果使用得当，将会使debug更有效率。

![261315330377843.jpg][]

第二部分：示例

在使用scripte componet的一个package，出现一个错误信息 “object reference not set to an instance of an object”

说明在 scripte componet的C\#代码中，并没有将对象设置为一个有效的实例。

![复制代码][copycode.gif]

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);
        }

![复制代码][copycode.gif]

从PreExecute函数中，可以看出，最有可能的错误原因是 cnManager 并没有获取到Package的Connection Manager

IDTSConnectionManager100 cnManager = Connections.Connection;

查看Script component的connection managers选项卡，已经设置了connection manager，那么错误的原因可能就是Name=Connection的Connection Manager的链接字符串有错误，导致无法连接到DB。

![261328595857416.jpg][]

经验证，最终的结果跟推测一样，Connection Manager的链接字符串有错误，无法连接到DB，导致Script component执行失败。

[261302392874125.jpg]: /images/20220617/dbdd6239770e489abf7106f207434436.png
[261303278038947.jpg]: /images/20220617/eaedade78e074c1c95f039891aee3894.png
[261304561932684.jpg]: /images/20220617/35a21999338a46559fa38bf0752ad903.png
[261301358499678.jpg]: /images/20220617/c21b24c282fe498d9c734d364905f9aa.png
[261307109126141.jpg]: /images/20220617/b570ecc2cf3f4296b446efb36e149841.png
[261309091315459.jpg]: /images/20220617/7581eaa792fc440a801b449a9ff01040.png
[261313364908770.jpg]: /images/20220617/65f5c6d02bea49b796df5a6194532f1e.png
[261315330377843.jpg]: /images/20220617/88ccb650447245979456efb82970459a.png
[copycode.gif]: /images/20220617/c70ea361dc9e48a3a71a757f2243aba4.png
[261328595857416.jpg]: /images/20220617/f4f0b4bccaf24dc8a5bce096634c3e54.png