在脚本组件中使用变量

适用范围:SQL Server Azure 数据工厂中的 SSIS Integration Runtime

变量存储包及其容器、任务和事件处理程序在运行时可以使用的值。 有关详细信息,请参阅 Integration Services (SSIS) 变量

在“脚本转换编辑器”的“脚本”页上的 ReadOnlyVariables 和 ReadWriteVariables 字段中输入逗号分隔的变量列表,可使现有变量能够由自定义脚本进行只读或读/写访问。 请注意,变量名称区分大小写。 使用 Value 属性可以从单个变量读取数据或向其中写入数据。 当脚本在运行时操作变量时,脚本组件将在后台处理任何所需的锁定。

重要

ReadWriteVariables 集合仅供在 PostExecute 方法中尽可能优化性能并降低锁定冲突的风险。 因此不能在处理每行数据时直接递增包变量的值, 而应递增本地变量的值,并在所有数据处理完毕后,在 PostExecute 方法中将包变量的值设置为本地变量的值。 还可以使用 VariableDispenser 属性解决此限制问题,本主题稍后会进行介绍。 但是,在处理每一行时直接写包变量将会对性能产生负面影响,并增加锁定冲突的风险。

有关“脚本转换编辑器”的“脚本”页的详细信息,请参阅在脚本组件编辑器中配置脚本组件脚本转换编辑器(“脚本”页)

脚本组件在 ComponentWrapper 项目项中创建一个 Variables 集合类,该集合类为每个预配置变量值包含一个强类型的取值函数属性,该属性与变量本身同名。 此集合通过 ScriptMain 类的 Variables 属性公开。 取值函数属性根据需要提供对变量值的只读或读/写权限。 例如,如果将名为 MyIntegerVariable 的整数变量添加到 ReadOnlyVariables 列表中,可在脚本中使用以下代码检索该变量的值

Dim myIntegerVariableValue As Integer = Me.Variables.MyIntegerVariable

还可以使用 VariableDispenser 属性(通过调用 Me.VariableDispenser 进行访问)在脚本组件中使用变量。 在这种情况下,使用的不是变量的已命名类型化取值函数属性,而是直接访问这些变量。 使用 VariableDispenser 时,您必须在您自己的代码中处理锁定语义和变量值的数据类型转换。 如果要使用在设计时不可用,而是以编程方式在运行时创建的变量,则必须使用 VariableDispenser 属性,而不是已命名的类型化取值函数属性。

另请参阅

Integration Services (SSIS) 变量
在包中使用变量