利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

时间:2023-03-08 17:02:51
利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

1,ForcedExecutionResult

强制一个package或task执行的结果,共有四种值 None,Success,Failure,Completion,默认值是None,表示不强制返回值。

如果设置ForcedExecutionResult=Success,不管package执行过程中是否出现异常,package执行的结果都是Success。

The default value of this property is None, which indicates that the container does not force its execution outcome.You can use the ForceExecutionResult property on a task or container to test the use of checkpoints in a package. By setting ForceExecutionResult of the task or container to Failure, you can imitate real-time failure. When you rerun the package, failed task and containers will be rerun.

2,如果一个Package design比较复杂,在调试的时候,会很头疼,每次都从头开始执行package显然比较耗时,可以利用SSIS的CheckPoint功能,从Package的错误点restart;如果某一个Task执行速度十分慢,但每次都能执行成功,当对这个task tune performance时,如何调试更有效率。使用Task的ForcedExecutionResult属性,设置ForcedExecutionResult=Failure,强制Task返回Failure。那么Restart时,就会从该Task开始执行。

示例,利用Task的ForcedExecutionResult属性和CheckPoint进行调试

Step1,创建测试表格和Control Flow design

CREATE TABLE [dbo].[ptest]
(
[id] [int] IDENTITY(1,1) NOT NULL,
[code] [int] NOT NULL,
CONSTRAINT [pk_ptest] PRIMARY KEY NONCLUSTERED
(
[id] ASC
)
)

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

Task insert1,Insert2,Insert3的Sql Statement分别是

--Task Insert1
insert into dbo.ptest(code)
values(1) --Task Insert2
insert into dbo.ptest(code)
values() --Task Insert3
insert into dbo.ptest(code)
values(3)

Step2,开启package的CheckPoint机制,并设置三个Execute Sql Task 的FailPackageOnFailure=true.

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

Step3,将Task Insert2的ForcedExecutionResult设置为Failure,执行Package,查看执行情况

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

Task Insert2 已经执行完成“100 percent complete”,查看数据库中的数据,sql语句正确执行,但是由于Task Insert2设置属性ForcedExecutionResult=Failure,即使执行成功,Task也会强制返回Failure。

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

step4,不做任何修改,重新执行package,查看执行情况

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

Step5,利用强大的Express属性动态设置组件的属性值

在调试组件的过程中,逐个修改ForcedExecutionResult的值,显得十分繁琐,可以利用组件的Expression来动态设置ForcedExecutionResult的值。

创建一个变量varForcedExecutionResult,DataType是Int32,初始化值为1。

ForcedExecutionResult的各个选项对应的整数值如下

-1=None

0=Success

1=Failure

2=Completion

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

修改Task Insert2的属性ForcedExecutionResult=None,并配置Expressions,设置ForcedExecutionResult=@[User::varForcedExecutionResult],Task Insert2的UI上面添加一个fx图标。

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

Step6,重新执行Package,查看执行情况

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

CheckPoint文件的内容中含有DTS:Variable section,package在restart时,会加载这些变量的值,如果变量的值在restart之前,在package中被修改,那么restart package时,SSIS只会加载CheckPoint文件中记录的变量值,而忽略Package中变量的初始值。

可以修改CheckPoint中变量的值,使Restart package时加载更新之后的变量值。

<DTS:Checkpoint xmlns:DTS="www.microsoft.com/SqlServer/Dts" DTS:PackageID="{DB02D0B1-82E5-45D8-AA94-5655572C5DF8}">
<DTS:Variables DTS:ContID="{DB02D0B1-82E5-45D8-AA94-5655572C5DF8}">
<DTS:Variable DTS:Namespace="User" DTS:IncludeInDebugDump="2345" DTS:ObjectName="varForcedExecutionResult" DTS:DTSID="{552910BC-B814-4B8B-8014-3E19997AD4ED}" DTS:CreationName="">
<DTS:VariableValue DTS:DataType="3">1</DTS:VariableValue>
</DTS:Variable>
</DTS:Variables>
<DTS:Container DTS:ContID="{BE14E7B0-21EC-4C23-922B-1240C9AC5C83}" DTS:Result="0" DTS:PrecedenceMap=""/>
</DTS:Checkpoint>

Step7,修改变量varForcedExecutionResult的初始值为-1,重新执行package,查看执行情况

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

原因是单纯的修改Package中的变量值,不修改CheckPoint文件中变量的值,Package只会加载CheckPoint文件中变量的值。

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package

Step8,修改CheckPoint中变量的值,<DTS:VariableValue DTS:DataType="3">-1</DTS:VariableValue>,重新执行package,查看执行情况

<DTS:Checkpoint xmlns:DTS="www.microsoft.com/SqlServer/Dts" DTS:PackageID="{DB02D0B1-82E5-45D8-AA94-5655572C5DF8}">
<DTS:Variables DTS:ContID="{DB02D0B1-82E5-45D8-AA94-5655572C5DF8}">
<DTS:Variable DTS:Namespace="User" DTS:IncludeInDebugDump="2345" DTS:ObjectName="varForcedExecutionResult" DTS:DTSID="{552910BC-B814-4B8B-8014-3E19997AD4ED}" DTS:CreationName="">
<DTS:VariableValue DTS:DataType="3">-1</DTS:VariableValue>
</DTS:Variable>
</DTS:Variables>
<DTS:Container DTS:ContID="{BE14E7B0-21EC-4C23-922B-1240C9AC5C83}" DTS:Result="0" DTS:PrecedenceMap=""/>
</DTS:Checkpoint>

利用SSIS的ForcedExecutionResult 属性 和CheckPoint调试Package