[译]Stairway to Integration Services Level 9 - Control Flow Task Errors

介绍

在本文中,我们会实验 MaximumErrorCount和ForceExecutioResult 故障容差属性,并且还要学习Control Flow task errors, event handlers 和 containers 的联系

关于 SSIS Task Errors

打开 Precedence.dtsx 包. 你的Control Flow 显示如下:

图 1

再做测试前我们先调整两个优先约束. Script Task 4 和 Script Task 3 调整如下:

图 2

Evaluation operation 选 Expression and Constraint 意味着表达式和执行状态都必须为Ture . 本列中的表达式MyBool的值必须为Ture,任务运行必须失败. 这样这个Task才算运行成功.

Script Tasks 2 和3 的优先约束配置如下:

图 3

只验证 Expression 表示只要表达式为True即可. 本例中表达式MyBool 的值为Ture那么task就执行成功,任务的执行状态直接忽略.

Execute a Test

按 F5 执行包(注意MyBool的值设置为True) 提示 Succeed Script Task 4?的死后选择No按钮:

图 4

如果你选择了No 按钮, Script Task 4 执行失败

图 5

Script Task 4 失败是因为我们选择No按钮,那为什么 Sequence Container 1 也失败呢?

事件冒泡 Events “Bubble”

错误是一个事件(event) An error is an event and events bubble. What is bubbling? 点击 Package Explorer . 展开 \Executables\Sequence Container 1\Executables\ 节点, 如图:

图 6

Script Task 4 执行失败,然后引发一个错误事件(这个时候 Script Task4 出现了一个红X表示Task失败) . 随后错误事件传递给Sequence Container 1 .由于这个错误在Sequence Container 1里面,所以Sequence Container 1也显示失败 .这种”范围提升”错误事件的传递叫做“冒泡(bubbling).” 这种错误事件不会停在 Sequence Container 1; 它会一直冒到 Precedence 包.

默认情况下错误事件会导致task或者container 失败 . 接下来我们看看如何操作默认属性.

MaximumErrorCount 属性

所有 tasks, 包括Script Task 4, 都有 MaximumErrorCount 属性. 默认情况下 MaximumErrorCount 属性是 1,也就是说只要出现一个错误就会导致task失败. 我们可以把这个属性改为99 ,如下图 :

图 7

再次执行包.我们发现 Sequence Container 1 还是失败了:

图 8

为什么会这样? 原因是 MaximumErrorCount 属性是专为 container设计的, 也就是说 MaximumErrorCount 用在task 上没有效果. 那如果我把Sequence Container 1 的MaximumErrorCount 属性改为99会怎么样?:

图 9

Sequence Container 1 显示成功.

大多数时候我希望出现一个错误,那么包就失败. 但是偶尔我希望把错误全部忽略. 为什么呢? 简单的说就是,忽略错误并不会阻止事件处理. 在本系列的第十篇文章(Advanced Event Behavior – Step 10 of the Stairway to Integration Services),我会进行解释. 我的好友 Julie Smith 分享了一个小技巧: 把MaximumErrorCount 属性设置为 0,也会忽略错误.

图 10

ForceExecutionResult 属性

另外一个使得Sequence Container 1 执行成功的方法是设置容器的 ForceExecutionResult 属性. 先把 MaximumErrorCount 属性改回默认值1 .然后把 ForceExecutionResult 属性改为 Success, 如下图 :

图 11

执行效果如下,即使 MaximumErrorCount 设为1 ,还是会被ForceExecutionResult忽视掉 :

图 12

错误事件 Error Events

每次Control Flow task错误.都会引起一个错误事件(Error Event). 错误事件会被记录然后往上传递. 在Event Handler 添加一个 OnError的 Script Task .我们看看 Error Event属性都有什么东东.

首先, 点击Control Flow 的 Script Task 4 . 然后点击 Event Handlers 标签 :

图 13

Event Handler 标签点开后,默认是没有配置的 OnErrorr Event Handler:

图 14

注意:你可以选择Executable的下拉项来选择其他 SSIS 包 :

图 15

当然那 Event handler 也可以选择. :

图 16

最后点击 “Click here to create an ‘OnError’ event handler for executable ‘Script Task 4’ :

图 17

点击后,看下OnError event handler的toolbox :

图 18

看上去很熟悉? 必须这样, 这个是 Control Flow toolbox! . 提供SSIS workflows 事件处理.响应事件.(我用的VS2013 ..看起来完全没变化..) . Event handlers 包括一组变量:

图 19

注意,这些是系统变量,如果你看到没显示,那么就是没把显示系统变量的钩打上. :

图 20

为了演示这些事件处理变量是如何工作的,拖一个 Script Task 到 OnError event handler 界面. 打开以后把 ScriptLanguage 属性设置为“Microsoft Visual Basic 2008” . 然后点击ReadOnlyVariables 选择下面几个变量System::ErrorCode, System::ErrorDescription, 和 System::SourceName :

图 21

点击OK按钮, 显示如下 :

图 22

点击e Edit Script 按钮,然后在 Public Sub Main() 里面把下面VB代码贴进去:

Dim iErrorCode As Integer = _
            Convert.ToInt32(Dts.Variables("ErrorCode").Value)
        Dim sErrorDescription As String = _
            Dts.Variables("ErrorDescription").Value.ToString
        Dim sSourceName As String = _
            Dts.Variables("SourceName").Value.ToString
        Dim sSubComponent As String = _
            "Script Task 4 OnError Event Handler"
        Dim sMsg As String = "Source: " & sSourceName & vbCrLf & _
                             "Error Code: " & iErrorCode.ToString & _
                             vbCrLf & _
                             "Error Description: " & _
                             sErrorDescription

        MsgBox(sMsg, , sSubComponent)

        Dts.TaskResult = ScriptResults.Success

Listing 1

Script Task Errors

如果 Script Task 没法定位 ReadOnlyVariables 属性指定的变量.就会报类似下面的错误:

Error: Failed to lock variable "System::ErrorCod" for read access with error 0xC0010001 "The variable cannot be found. This occurs when an attempt is made to retrieve a variable from the Variables collection on a container during execution of the package, and the variable is not there. The variable name may have changed or the variable is not being created.". Listing 2

我碰到到这个错误是把System::ErrorCode 最后一个’e’漏掉了. 然后执行后报错 :

图 23