通用属性

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

DTSRowDisposition

用于指定错误的处理方式的值。具体的值为 Fail component、Ignore failure 和 Redirect row。

HasSideEffects

Boolean

指示当组件没有附加到下游组件并且 RunInOptimizedMode 为 true 时,是否可以从数据流的执行计划中删除该组件。

ID

Integer

用于唯一标识输入的值。

IdentificationString

String

用于标识输入的字符串。

IsSorted

Boolean

指示输入中的数据是否已排序。

Name

String

输入的名称。

SourceLocale

Integer

输入数据的区域设置 ID (LCID)。

TruncationRowDisposition

DTSRowDisposition

用于确定组件如何处理在处理行时发生的截断的值。具体的值为 Fail component、Ignore failure 和 Redirect row。

目标以及某些转换不支持错误输出,这些组件的 ErrorRowDispositionTruncationRowDisposition 属性是只读的。

输入列属性

在 Integration Services 对象模型中,输入包含输入列集合。数据流中的组件的输入列实现了 IDTSInputColumn100 接口。

下表描述了数据流中的组件的输入列属性。其中某些属性的值是只读的,由数据流引擎在运行时分配。

属性

数据类型

说明

ComparisonFlags

Integer

一组标志,用于指定数据类型为 character 的列的比较方式。有关详细信息,请参阅比较字符串数据

Description

String

对输入列的说明。

ErrorOrTruncationOperation

String

一个可选字符串,它指定处理行时可以发生的错误或截断的类型。

ErrorRowDisposition

DTSRowDisposition

用于指定错误的处理方式的值。具体的值为 Fail component、Ignore failure 和 Redirect row。

ExternalMetadataColumnID

IDTSExternalMetadataColumn100

分配给输入列的外部元数据列的 ID。

ID

Integer

用于唯一标识输入列的值。

IdentificationString

String

用于标识输入列的字符串。

LineageID

Integer

上游列的 ID。

Name

String

输入列的名称。

SortKeyPosition

Integer

用于指示单个列是否已排序、其排序顺序以及多个列的排序顺序的值。值为 0 时,表示未对列进行排序。有关详细信息,请参阅如何为合并转换和合并联接转换排序数据

TruncationRowDisposition

DTSRowDisposition

用于确定组件如何处理在处理行时发生的截断的值。具体的值为 Fail component、Ignore failure 和 Redirect row。

UpstreamComponentName

String

上游组件的名称。

UsageType

DTSUsageType

用于确定组件如何使用输入列的值。

输入列还具有“数据类型属性”下描述的数据类型属性。

输出属性

在 Integration Services 对象模型中,源和转换具有输出。数据流中的组件的输出实现了 IDTSOutput100 接口。

下表描述了数据流中的组件的输出属性。其中某些属性的值是只读的,由数据流引擎在运行时分配。

属性

数据类型

说明

DeleteOutputOnPathDetached

Boolean

用于确定当输出与路径分离时数据流引擎是否将其删除的值。

Description

String

对输出的说明。

ErrorOrTruncationOperation

String

一个可选字符串,它指定处理行时可以发生的错误或截断的类型。

ErrorRowDisposition

DTSRowDisposition

用于指定错误的处理方式的值。具体的值为 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

DTSRowDisposition

用于确定组件如何处理在处理行时发生的截断的值。具体的值为 Fail component、Ignore failure 和 Redirect row。

输出列属性

在 Integration Services 对象模型中,输出包含输出列集合。数据流中的组件的输出列实现了 IDTSOutputColumn100 接口。

下表描述了数据流中的组件的输出列属性。其中某些属性的值是只读的,由数据流引擎在运行时分配。

属性

数据类型

说明

ComparisonFlags

Integer

一组标志,用于指定数据类型为 character 的列的比较方式。有关详细信息,请参阅比较字符串数据

Description

String

对输出列的说明。

ErrorOrTruncationOperation

String

一个可选字符串,它指定处理行时可以发生的错误或截断的类型。

ErrorRowDisposition

DTSRowDisposition

用于指定错误的处理方式的值。具体的值为 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

DTSRowDisposition

用于确定组件如何处理在处理行时发生的截断的值。具体的值为 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

数字列的小数位数。