通用属性
Microsoft SQL Server Integration Services 对象模型中的数据流对象在组件级、输入和输出级以及输入列和输出列级具有通用属性和自定义属性。 其中许多属性的值是只读的,由数据流引擎在运行时分配。
本主题列出并描述了数据流对象的通用属性。
组件
输入
输入列
输出
输出列
有关客户属性的信息,请参阅下面的主题
OLE DB 自定义属性OLE DB 自定义属性
组件属性
在 Integration Services 对象模型中,数据流中的组件实现 IDTSComponentMetaData100 接口。
下表介绍了数据流中的组件的属性。 其中某些属性的值是只读的,由数据流引擎在运行时分配。
属性 |
数据类型 |
说明 |
---|---|---|
ComponentClassID |
String |
组件的 CLSID。 |
ContactInfo |
String |
组件开发人员的联系信息。 |
Description |
String |
对数据流组件的说明。 此属性的默认值是数据流组件的名称。 |
ID |
Integer |
唯一标识此组件实例的值。 |
IdentificationString |
String |
标识组件。 |
IsDefaultLocale |
Boolean |
指示组件是否使用其所属的数据流任务的区域设置。 |
LocaleID |
Integer |
包运行时数据流组件使用的区域设置。 数据流组件可以使用所有 Windows 区域设置。 |
Name |
String |
数据流组件的名称。 |
PipelineVersion |
Integer |
将某组件设计为要在其中执行的数据流任务的版本。 |
UsesDispositions |
Boolean |
指示组件是否有错误输出。 |
ValidateExternalMetadata |
Boolean |
指示外部列的元数据是否经过验证。 此属性的默认值为 True。 |
Version |
Integer |
组件的版本。 |
输入属性
在 Integration Services 对象模型中,转换和目标都具有输入。 数据流中的组件的输入实现了 IDTSInput100 接口。
下表描述了数据流中的组件的输入属性。 其中某些属性的值是只读的,由数据流引擎在运行时分配。
属性 |
数据类型 |
说明 |
---|---|---|
Description |
String |
输入的说明。 |
ErrorOrTruncationOperation |
String |
一个可选字符串,它指定处理行时可以发生的错误或截断的类型。 |
ErrorRowDisposition |
用于指定错误的处理方式的值。 具体的值为 Fail component、Ignore failure 和 Redirect row。 |
|
HasSideEffects |
Boolean |
指示当组件没有附加到下游组件并且 RunInOptimizedMode 为 true 时,是否可以从数据流的执行计划中删除该组件。 |
ID |
Integer |
用于唯一标识输入的值。 |
IdentificationString |
String |
用于标识输入的字符串。 |
IsSorted |
Boolean |
指示输入中的数据是否已排序。 |
Name |
String |
输入的名称。 |
SourceLocale |
Integer |
输入数据的区域设置 ID (LCID)。 |
TruncationRowDisposition |
用于确定组件如何处理在处理行时发生的截断的值。 . 具体的值为 Fail component、Ignore failure 和 Redirect row。 |
目标以及某些转换不支持错误输出,这些组件的 ErrorRowDisposition 和 TruncationRowDisposition 属性是只读的。
输入列属性
在 Integration Services 对象模型中,输入包含输入列集合。 数据流中的组件的输入列实现了 IDTSInputColumn100 接口。
下表描述了数据流中的组件的输入列属性。 其中某些属性的值是只读的,由数据流引擎在运行时分配。
属性 |
数据类型 |
说明 |
---|---|---|
ComparisonFlags |
Integer |
一组标志,用于指定数据类型为 character 的列的比较方式。 有关详细信息,请参阅比较字符串数据。 |
Description |
String |
对输入列的说明。 |
ErrorOrTruncationOperation |
String |
一个可选字符串,它指定处理行时可以发生的错误或截断的类型。 |
ErrorRowDisposition |
用于指定错误的处理方式的值。 具体的值为 Fail component、Ignore failure 和 Redirect row。 |
|
ExternalMetadataColumnID |
分配给输入列的外部元数据列的 ID。 |
|
ID |
Integer |
用于唯一标识输入列的值。 |
IdentificationString |
String |
用于标识输入列的字符串。 |
LineageID |
Integer |
上游列的 ID。 |
Name |
String |
输入列的名称。 |
SortKeyPosition |
Integer |
用于指示单个列是否已排序、其排序顺序以及多个列的排序顺序的值。 值为 0 时,表示未对列进行排序。 有关详细信息,请参阅为合并转换和合并联接转换排序数据。 |
TruncationRowDisposition |
用于确定组件如何处理在处理行时发生的截断的值。 具体的值为 Fail component、Ignore failure 和 Redirect row。 |
|
UpstreamComponentName |
String |
上游组件的名称。 |
UsageType |
用于确定组件如何使用输入列的值。 |
输入列还具有“数据类型属性”下描述的数据类型属性。
输出属性
在 Integration Services 对象模型中,源和转换具有输出。 数据流中的组件的输出实现了 IDTSOutput100 接口。
下表描述了数据流中的组件的输出属性。 其中某些属性的值是只读的,由数据流引擎在运行时分配。
属性 |
数据类型 |
说明 |
||
---|---|---|---|---|
DeleteOutputOnPathDetached |
Boolean |
用于确定当输出与路径分离时数据流引擎是否将其删除的值。 |
||
Description |
String |
对输出的说明。 |
||
ErrorOrTruncationOperation |
String |
一个可选字符串,它指定处理行时可以发生的错误或截断的类型。 |
||
ErrorRowDisposition |
用于指定错误的处理方式的值。 具体的值为 Fail component、Ignore failure 和 Redirect row。 |
|||
ExclusionGroup |
Integer |
用于标识一组互斥输出的值。 |
||
HasSideEffects |
Boolean |
用于指示当组件没有附加到上游组件并且 RunInOptimizedMode 为 true 时是否可以从数据流的执行计划中删除该组件的值。 |
||
ID |
Integer |
用于唯一标识输出的值。 |
||
IdentificationString |
String |
用于标识输出的字符串。 |
||
IsErrorOut |
Boolean |
指示输出是否为错误输出。 |
||
IsSorted |
Boolean |
指示输出是否已排序。 默认值为 False。
|
||
Name |
String |
输出的名称。 |
||
SynchronousInputID |
Integer |
与输出同步的输入的 ID。 |
||
TruncationRowDisposition |
用于确定组件如何处理在处理行时发生的截断的值。 具体的值为 Fail component、Ignore failure 和 Redirect row。 |
输出列属性
在 Integration Services 对象模型中,输出包含输出列集合。 数据流中的组件的输出列实现了 IDTSOutputColumn100 接口。
下表描述了数据流中的组件的输出列属性。 其中某些属性的值是只读的,由数据流引擎在运行时分配。
属性 |
数据类型 |
说明 |
---|---|---|
ComparisonFlags |
Integer |
一组标志,用于指定数据类型为 character 的列的比较方式。 有关详细信息,请参阅比较字符串数据。 |
Description |
String |
对输出列的说明。 |
ErrorOrTruncationOperation |
String |
一个可选字符串,它指定处理行时可以发生的错误或截断的类型。 |
ErrorRowDisposition |
用于指定错误的处理方式的值。 具体的值为 Fail component、Ignore failure 和 Redirect row。 默认值为 Fail component。 |
|
ExternalMetadataColumnID |
Integer |
分配给输入列的外部元数据列的 ID。 |
ID |
Integer |
用于唯一标识输出列的值。 |
IdentificationString |
String |
用于标识输出列的字符串。 |
LineageID |
Integer |
输出列的 ID。 下游组件使用此值引用列。 |
Name |
String |
输出列的名称。 |
SortKeyPosition |
Integer |
用于指示单个列是否已排序、其排序顺序以及多个列的排序顺序的值。 值为 0 时,表示未对列进行排序。 有关详细信息,请参阅为合并转换和合并联接转换排序数据。 |
SpecialFlags |
Integer |
包含输出列的特殊标志的值。 |
TruncationRowDisposition |
用于确定组件如何处理在处理行时发生的截断的值。 具体的值为 Fail component、Ignore failure 和 Redirect row。 默认值为 Fail component。 |
输出列还包括一组数据类型属性。
外部元数据列属性
在 Integration Services 对象模型中,输入和输出可以包含一组外部元数据列。 数据流中的组件的外部元数据列实现了 IDTSExternalMetadataColumn100 接口。
下表描述了数据流中的组件的外部元数据列属性。 其中某些属性的值是只读的,由数据流引擎在运行时分配。
属性 |
数据类型 |
说明 |
---|---|---|
Description |
String |
对外部列的说明。 |
ID |
Integer |
用于唯一标识列的值。 |
IdentificationString |
String |
用于标识列的字符串。 |
Name |
String |
外部列的名称。 |
外部元数据列还包括一组数据类型属性。
数据类型属性
输出列和外部元数据列还包括一组数据类型属性。 这些属性可能为读/写属性或只读属性,具体取决于列的数据类型。
下表描述了输出列和外部元数据列的数据类型属性。
属性 |
数据类型 |
说明 |
---|---|---|
CodePage |
Integer |
指定非 Unicode 字符串数据的代码页。 |
DataType |
Integer(枚举) |
列的 Integration Services 数据类型。 有关详细信息,请参阅 Integration Services 数据类型。 |
Length |
Integer |
以字符计的列的长度。 |
Precision |
Integer |
数字列的精度。 |
Scale |
Integer |
数字列的小数位数。 |