通用属性
Microsoft SQL Server Integration Services 对象模型中的数据流对象在组件级、输入和输出级以及输入列和输出列级具有通用属性和自定义属性。其中许多属性的值是只读的,由数据流引擎在运行时分配。
本主题列出并描述了数据流对象的通用属性。
组件
输入
输入列
输出
输出列
组件属性
在 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。
重要提示
将 IsSorted 属性的值设置为 True 时将不会对数据进行排序。此属性仅向下游组件提示数据之前已经过排序。有关详细信息,请参阅如何为合并转换和合并联接转换排序数据。
|
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 |
数字列的小数位数。 |