OLE DB Command transformation 用法

Posted 2020-09-09 郑兴鹏

OLE DB Command transformation component 能够引用参数，逐行调用sqlcommand，This transformation is typically used for running parameterized queries。

1，自定义属性

OLE DB Command Transformation 是一个功能十分强大的组件，但是其配置属性却是十分简单，只有三个自定义属性，如图

SqlCommand ：要执行的sql 命令，使用 ？ 代替一个参数，参数的值来源于上游组件的输入。

2，参数

OLE DB Command transformation Component 是一行一行进行转换的，特别是SqlCommand中可以使用参数。The parameter values are stored in external columns in the transformation input, and mapping an input column to an external column maps an input column to a parameter。

2.1 sqlcommand引用参数值

OLEDB 链接不同于Adonet链接，对参数的引用是不同的。OLEDB 链接使用？代表一个参数，？的序号从0开始，是固定的，Oledb通过序号来引用参数。

sqlcommand 用？ 来引用对应序号的参数。第一个参数，序号为0，sqlcommand中第一个？引用该参数。

update dbo.tis set name=name+\'_update\' where code=?

type the parameterized SQL statement using a question mark (?) as the parameter marker for each parameter.

2.2 设置column mappings

在sqlcommand引用参数之后，点击refresh按钮，组件自动识别？，然后生成参数，参数名的命名规则是Param_Ordinal，需要在column mappings选项卡中设置参数的值和上游组件的输入的column之间的mapping，用于设置参数值的来源。Available input columns 是上游组件的输入列，Available destination columns是自动生成的参数列。

Click Refresh. When you click Refresh, the transformation creates a column for each parameter in the External Columns collection and sets the DBParamInfoFlags property.

示例：Param_0参数的值是由Code赋值的。

2.3 查看参数信息

在 Input and Output Properties选项卡中，选择OLE DB命令输入-》external columns，可以看到组件自动添加一个参数Param_0，其数值来源于Input Columns。注意check参数的DataType，CodePage 和MappedColumnID。MappedColumnID就是参数在sqlcommand中的序号。

Verify that External Columns lists a column for each parameter in the SQL statement. The column names are Param_0, Param_1, and so on.

You should not change the column names. If you change the column names, Integration Services generates a validation error for the OLE DB Command transformation. 

Also, you should not change the data type. The DataType property of each column is set to the correct data type.

DBParamInfoFlags 是一个Custom Properties，用于 匹配Oledb的DBPrarmflagsenum，DBParamInfoFlags 的值表示参数的特征。例如，值 1 指定参数为输入参数，而值 65 则指定参数为输入参数，数据类型是字符型，且可能包含空值，81指定参数为输入参数，参数的数据类型是int。

If External Columns lists no columns you must add them manually.

• Click Add Column one time for each parameter in the SQL statement.

• Update the column names to Param_0, Param_1, and so on.

• Specify a value in the DBParamInfoFlags property. The value must match a value in the OLE DB DBPARAMFLAGSENUM enumeration. For more information, see the OLE DB reference documentation.

• Specify the data type of the column and, depending on the data type, specify the code page, length, precision, and scale of the column.

• To delete an unused parameter, select the parameter in External Columns, and then click Remove Column.

• Click Column Mappings and map columns in the Available Input Columns list to parameters in the Available Destination Columns list.

 

 在input columns中的属性

ExternalMetadataColumnID：指定input column的值要流向的external column的ID

 

 

MSDN对OLE DB Command transformation　component的介绍如下： 

The OLE DB Command transformation runs an SQL statement for each row in a data flow. For example, you can run an SQL statement that inserts, updates, or deletes rows in a database table.

You can configure the OLE DB Command Transformation in the following ways:

• Provide the SQL statement that the transformation runs for each row.

• Specify the number of seconds before the SQL statement times out.

• Specify the default code page.

Typically, the SQL statement includes parameters. The parameter values are stored in external columns in the transformation input, and mapping an input column to an external column maps an input column to a parameter. For example, to locate rows in the DimProduct table by the value in their ProductKey column and then delete them, you can map the external column named Param_0 to the input column named ProductKey, and then run the SQL statement DELETE FROM DimProduct WHERE ProductKey = ?.. The OLE DB Command transformation provides the parameter names and you cannot modify them. The parameter names are Param_0, Param_1, and so on.

If you configure the OLE DB Command transformation by using the Advanced Editor dialog box, the parameters in the SQL statement may be mapped automatically to external columns in the transformation input, and the characteristics of each parameter defined, by clicking the Refresh button. However, if the OLE DB provider that the OLE DB Command transformation uses does not support deriving parameter information from the parameter, you must configure the external columns manually. This means that you must add a column for each parameter to the external input to the transformation, update the column names to use names like Param_0, specify the value of the DBParamInfoFlags property, and map the input columns that contain parameter values to the external columns.

The value of DBParamInfoFlags represents the characteristics of the parameter. For example, the value 1 specifies that the parameter is an input parameter, and the value 65 specifies that the parameter is an input parameter and may contain a null value. The values must match the values in the OLE DB DBPARAMFLAGSENUM enumeration. For more information, see the OLE DB reference documentation.

The OLE DB Command transformation includes the SQLCommand custom property. This property can be updated by a property expression when the package is loaded. For more information, see Integration Services (SSIS) Expressions, Use Property Expressions in Packages, and Transformation Custom Properties.

This transformation has one input, one regular output, and one error output.