脚本组件
适用于：
SQL Server Azure 数据工厂中的 SSIS Integration Runtime
脚本组件承载脚本，并使包能够包含和运行自定义的脚本代码。 可以将包中的脚本组件用于下列目的：
将多个转换应用于数据，而不是在数据流中使用多个转换。 例如，脚本可以将两列中的值相加，然后计算和的平均值。
访问现有 .NET 程序集中的业务规则。 例如，脚本可以应用指定 Income 列中有效值范围的业务规则。
除 Integration Services 表达式语法提供的函数和运算符之外，还可使用自定义公式和函数。 例如，使用 LUHN 公式验证信用卡号。
验证列数据，并跳过包含无效数据的记录。 例如，脚本可以评估邮资额的合理性，并跳过金额过高或过低的记录。
脚本组件为将自定义函数纳入数据流提供了简便快捷的方法。 但是，如果您计划在多个包中重新使用脚本代码，则应考虑编写自定义组件，而不使用脚本组件。 有关详细信息，请参阅 开发自定义数据流组件。
注意
如果脚本组件包含尝试读取 NULL 列值的脚本，则在您运行包时此脚本组件将失败。 建议你的脚本先使用 IsNull 方法确定相应列是否为 NULL，再尝试读取该列的值。
脚本组件可用作源、转换或目标。 该组件支持一个输入和多个输出。 根据其使用方式，该组件可以支持一个输入或多个输出，也可二者都支持。 脚本由输入或输出中的每一行调用。
如果用作源，则脚本组件支持多个输出。
如果用作转换，则脚本组件支持一个输入和多个输出。
如果用作目标，则脚本组件支持一个输入。
脚本组件不支持错误输出。
确定将此脚本组件作为包的正确选择之后，必须配置输入和输出、开发该组件使用的脚本并配置组件本身。
了解脚本组件模式
在 SSIS 设计器中，脚本组件具有两种模式：元数据设计模式和代码设计模式。 在元数据设计模式中，可以添加和修改脚本组件的输入和输出，但不能编写代码。 配置完所有的输入和输出后，即可切换至代码设计模式编写脚本。 脚本组件从输入和输出的元数据自动生成基代码。 如果在脚本组件生成基代码后更改元数据，则您的代码可能无法再编译，因为更新的基代码可能与您的代码不兼容。
编写组件使用的脚本
脚本组件将 Microsoft Visual Studio Tools for Applications (VSTA) 用作编写脚本的环境。 您可以从 “脚本转换编辑器” 访问 VSTA。 有关详细信息，请参阅脚本转换编辑器（“脚本”页）。
脚本组件提供一个 VSTA 项目，其中包含一个名为 ScriptMain 的自动生成的类，表示组件元数据。 例如，如果将脚本组件用作具有三个输出的转换，则 ScriptMain 为每个输出都包含一种方法。 ScriptMain 是脚本的入口点。
VSTA 包含 Visual Studio 环境的所有标准功能，如具有颜色编码的 Visual Studio 编辑器、IntelliSense 和对象浏览器。 脚本组件使用的脚本存储在包定义中， 设计包时，脚本代码将临时写入项目文件。
VSTA 支持 Microsoft Visual C# 和 Microsoft Visual Basic 编程语言。
有关如何对脚本组件进行编程的信息，请参阅 使用脚本组件扩展数据流。 有关如何将脚本组件配置为源、转换或目标的更多特定信息，请参阅 Developing Specific Types of Script Components。 有关说明脚本组件使用的其他示例（如 ODBC 目标），请参阅 Additional Script Component Examples。
注意
在早期版本中您可以指示是否对脚本进行预编译，而在 SQL Server 2008 Integration Services (SSIS) 和更高版本中，不同的是，所有脚本都要预编译。 脚本进行预编译后，运行时将不加载语言引擎，因此包运行得更快。 但是，预编译二进制文件占用了大量的磁盘空间。
配置脚本组件
可以采用下列方法来配置脚本组件：
选择要引用的输入列。
备注
使用 SSIS 设计器时，可以仅配置一个输入。
提供组件运行的脚本。
指定脚本语言。
提供逗号分隔的只读和读/写变量列表。
添加更多输出，并且添加脚本要向其赋值的输出列。
可以通过 SSIS 设计器或以编程方式来设置属性。
配置设计器中的脚本组件
有关如何在 SSIS 设计器中设置这些属性的详细信息，请单击下列主题：
以编程方式配置脚本组件
有关可在 “属性” 窗口中或以编程形式设置的属性的详细信息，请单击以下主题之一：
有关如何设置属性的详细信息，请单击下列主题之一：
选择脚本组件类型
可以使用 “选择脚本组件类型” 对话框，指定是否创建预配置为源、转换或目标的脚本转换。
要了解有关脚本组件的详细信息，请参阅在脚本组件编辑器中配置脚本组件。 若要了解如何对脚本组件进行编程，请参阅 使用脚本组件扩展数据流。
选项
选择 “源” 、 “目标” 或 “转换” 将影响脚本转换的配置和脚本转换编辑器所显示的页。
脚本转换编辑器（“连接管理器”页）
可以使用 脚本转换编辑器 的 “连接管理器” 页指定脚本将使用的任何连接。
要了解有关脚本组件的详细信息，请参阅在脚本组件编辑器中配置脚本组件。 若要了解如何对脚本组件进行编程，请参阅 使用脚本组件扩展数据流。
选项
Connection managers
查看脚本可使用的连接列表。
名称
为连接键入唯一的描述性名称。
连接管理器
从可用的连接管理器列表中选择，或选择“<新建连接>”以打开“添加 SSIS 连接管理器”对话框。
说明
输入连接的说明。
添加
向“连接管理器”列表中添加另外一个连接 。
删除
从“连接管理器” 列表中删除所选连接。
脚本转换编辑器（“输入列”页）
可以使用 “脚本转换编辑器” 对话框的 “输入列” 页设置输入列的属性。
备注
由于源组件只有输出而没有输入，因此对于源组件不能显示“输入列”页 。
要了解有关脚本组件的详细信息，请参阅在脚本组件编辑器中配置脚本组件。 若要了解如何对脚本组件进行编程，请参阅 使用脚本组件扩展数据流。
选项
输入名称
从可用输入的列表中选择。
可用输入列
使用复选框指定脚本转换要使用的列。
输入列
从每行的可用输入列的列表中选择。 通过选中“可用输入列” 表中的复选框来选择列。
输出别名
为每个输出列键入一个别名。 默认值为输入列的名称；不过，您也可以任选一个唯一的描述性名称。
使用类型
指定脚本转换是将每个列视为 ReadOnly 还是 ReadWrite。
脚本转换编辑器（“输入和输出”页）
可以使用 “脚本转换编辑器” 对话框的 “输入和输出” 页，添加、删除和配置脚本转换的输入和输出。
注意
源组件有输出但没有输入，而目标组件有输入但没有输出。 转换既有输入，也有输出。
要了解有关脚本组件的详细信息，请参阅在脚本组件编辑器中配置脚本组件。 若要了解如何对脚本组件进行编程，请参阅 使用脚本组件扩展数据流。
选项
Inputs and outputs
在左侧选择输入或输出即可在右侧的表中查看其属性。 选择不同的输入或输出，可编辑的属性也有所不同。 显示的许多属性是只读的。 有关各个属性的详细信息，请参阅以下主题：
添加输出
将其他输出添加到列表中。
添加列
选择用于放置新输出列的文件夹，再单击“添加列” 来添加该列。
删除输出
选择某个输出，再单击“删除输出” 即可将其删除。
删除列
选择某个列，然后单击“删除列” 来删除该列。
脚本转换编辑器（“脚本”页）
可以使用 “脚本转换编辑器” 对话框的 “脚本” 选项卡指定脚本及相关属性。
要了解有关脚本组件的详细信息，请参阅在脚本组件编辑器中配置脚本组件。 若要了解如何对脚本组件进行编程，请参阅 使用脚本组件扩展数据流。
选项
属性
查看和修改脚本转换的属性。 显示的许多属性是只读的。 您可以修改以下属性：
| 值 | 说明 |
|---|---|
| 说明 | 说明脚本转换的用途。 |
| LocaleID | 指定区域设置，以便为排序以及日期和时间转换提供区域特定的信息。 |
| 名称 | 为组件键入说明性名称。 |
| ValidateExternalMetadata | 指示在设计时脚本转换是否要根据外部数据源对列的元数据进行验证。 如果值为 false ，则会将验证延迟到执行时。 |
| ReadOnlyVariables | 以逗号分隔的形式键入一列可供脚本转换只读访问的变量。 注意：变量名称区分大小写。 |
| ReadWriteVariables | 以逗号分隔的形式键入一列可供脚本转换读/写访问的变量。 注意：变量名称区分大小写。 |
| ScriptLanguage | 选择脚本组件要使用的脚本语言。 若要设置脚本组件和脚本任务的默认脚本语言，请使用 “选项” 对话框的 “常规” 页上的 “脚本语言” 选项。 |
| UserComponentTypeName | 指定支持 ScriptComponentHost ScriptComponentHost 类和 Microsoft.SqlServer.TxScript SQL Server 程序集。 |
编辑脚本
使用 Microsoft Visual Studio Tools for Applications (VSTA) 创建或修改脚本。
相关内容
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈