共用方式為


Common Properties

更新: 2006 年 4 月 14 日

The data flow objects in the Microsoft SQL Server 2005 Integration Services object model have common properties and custom properties at the component, input and output, and input column and output column levels. Many properties have read-only values that are assigned at run time by the data flow engine.

This topic lists and describes the common properties of data flow objects.

  • Components
  • Inputs
  • Input columns
  • Outputs
  • Output columns

Component Properties

In the Integration Services object model, a component in the data flow implements the IDTSComponentMetaData90 interface.

The following table describes the properties of the components in a data flow. Some properties have read-only values that are assigned at run time by the data flow engine.

Property Data Type Description

ComponentClassID

String

The CLSID of the component.

ContactInfo

String

Contact information for the developer of a component.

Description

String

The description of the data flow component. The default value of this property is the name of the data flow component.

ID

Integer

A value that uniquely identifies this instance of the component.

IdentificationString

String

Identifies the component.

IsDefaultLocale

Boolean

Indicates whether the component uses the locale of the Data Flow task to which it belongs.

LocaleID

Integer

The locale that the data flow component uses when the package runs. All Windows locales are available for use in data flow components.

Name

String

The name of the data flow component.

PipelineVersion

Integer

The version of the data flow task within which a component is designed to execute.

UsesDispositions

Boolean

Indicates whether a component has an error output.

ValidateExternalMetadata

Boolean

Indicates whether the metadata of external columns is validated. The default value of this property is True.

Version

Integer

The version of a component.

Input Properties

In the Integration Services object model, transformations and destinations have inputs. An input of a component in the data flow implements the IDTSInput90 interface.

The following table describes the properties of the inputs of components in a data flow. Some properties have read-only values that are assigned at run time by the data flow engine..

Property Data Type Description

Description

String

The description of the input.

ErrorOrTruncationOperation

String

An optional string that specifies the types of errors or truncations that can occur when processing a row.

ErrorRowDisposition

DTSRowDisposition

A value that specifies the handling of errors. The values are Fail component, Ignore failure, and Redirect row.

HasSideEffects

Boolean

Indicates whether a component can be removed from the execution plan of the data flow when it is not attached to a downstream component and when RunInOptimizedMode is true.

ID

Integer

A value that uniquely identifies the input.

IdentificationString

String

A string that identifies the input.

IsSorted

Boolean

Indicates whether the data in the input is sorted.

Name

String

The name of the input.

SourceLocale

Integer

The locale ID (LCID) of the input data.

TruncationRowDisposition

DTSRowDisposition

A value that determines how the component handles truncations that occur when processing rows. . The values are Fail component, Ignore failure, and Redirect row.

Destinations and some transformations do not support error outputs, and the ErrorRowDisposition and TruncationRowDisposition properties of these components are read-only.

Input Column Properties

In the Integration Services object model, an input contains a collection of input columns. An input column of a component in the data flow implements the IDTSInputColumn90 interface.

The following table describes the properties of the input columns of components in a data flow. Some properties have read-only values that are assigned at run time by the data flow engine.

Property Data Type Description

ComparisonFlags

Integer

A set of flags that specify the comparison of columns that have a character data type. For more information, see 比較字串資料.

Description

String

Describes the input column.

ErrorOrTruncationOperation

String

An optional string that specifies the types of errors or truncations that can occur when processing a row.

ErrorRowDisposition

DTSRowDisposition

A value that specifies the handling of errors. The values are Fail component, Ignore failure, and Redirect row.

ExternalMetadataColumnID

IDTSExternalMetadataColumn90

The ID of the external metadata column assigned to an input column.

ID

Integer

A value that uniquely identifies the input column.

IdentificationString

String

A string that identifies the input column.

LineageID

Integer

The ID of the upstream column.

Name

String

The name of the input column.

SortKeyPosition

Integer

The sort position and sort direction of a sorted column.

TruncationRowDisposition

DTSRowDisposition

A value that determines how the component handles truncations that occur when processing rows. The values are Fail component, Ignore failure, and Redirect row.

UpstreamComponentName

String

The name of the upstream component.

UsageType

DTSUsageType

A value that determines how an input column is used by the component.

Input columns also have the data type properties described under "Data Type Properties."

Output Properties

In the Integration Services object model, sources and transformations have outputs. An output of a component in the data flow implements the IDTSOutput90 interface.

The following table describes the properties of the outputs of components in a data flow. Some properties have read-only values that are assigned at run time by the data flow engine.

Property Data Type Description

DeleteOutputOnPathDetached

Boolean

A value that determines whether the data flow engine deletes the output when it is detached from a path.

Description

String

Describes the output.

ErrorOrTruncationOperation

String

An optional string that specifies the types of errors or truncations that can occur when processing a row.

ErrorRowDisposition

DTSRowDisposition

A value that specifies the handling of errors. The values are Fail component, Ignore failure, and Redirect row.

ExclusionGroup

Integer

A value that identifies a group of mutually exclusive outputs.

HasSideEffects

Boolean

A value that indicates whether a component can be removed from the execution plan of the data flow when it is not attached to an upstream component and when RunInOptimizedMode is true.

ID

Integer

A value that uniquely identifies the output.

IdentificationString

String

A string that identifies the output.

IsErrorOut

Boolean

Indicates whether the output is an error output.

IsSorted

Boolean

Indicates whether the output is sorted. The default value is False.

Name

String

The name of the output.

SynchronousInputID

Integer

The ID of an input that is synchronous to the output.

TruncationRowDisposition

DTSRowDisposition

A value that determines how the component handles truncations that occur when processing rows. The values are Fail component, Ignore failure, and Redirect row.

Output Column Properties

In the Integration Services object model, an output contains a collection of output columns. An output column of a component in the data flow implements the IDTSOutputColumn90 interface.

The following table describes the properties of the output columns of components in a data flow. Some properties have read-only values that are assigned at run time by the data flow engine.

Property Data Type Description

ComparisonFlags

Integer

A set of flags that specify the comparison of columns that have a character data type. For more information, see 比較字串資料.

Description

String

Describes the output column.

ErrorOrTruncationOperation

String

An optional string that specifies the types of errors or truncations that can occur when processing a row.

ErrorRowDisposition

DTSRowDisposition

A value that specifies the handling of errors. The values are Fail component, Ignore failure, and Redirect row. The default value is Fail component.

ExternalMetadataColumnID

Integer

The ID of the external metadata column assigned to an input column.

ID

Integer

A value that uniquely identifies the output column.

IdentificationString

String

A string that identifies the output column.

LineageID

Integer

The ID of the output column. Downstream components refer to the column by using this value.

Name

String

The name of the output column.

SortKeyPosition

Integer

A value that indicates whether a column is sorted, its sort order, and the sequence in which multiple columns are sorted. The value 0 indicates the column is not sorted.

SpecialFlags

Integer

A value that contains the special flags of the output column.

TruncationRowDisposition

DTSRowDisposition

A value that determines how the component handles truncations that occur when processing rows. The values are Fail component, Ignore failure, and Redirect row. The default value is Fail component.

Output columns also include a set of data type properties.

External Metadata Column Properties

In the Integration Services object model, inputs and outputs can contain a collection of external metadata columns. An external metadata column of a component in the data flow implements the IDTSExternalMetadataColumn90 interface.

The following table describes the properties of the external metadata columns of components in a data flow. Some properties have read-only values that are assigned at run time by the data flow engine.

Property Data Type Description

Description

String

Describes the external column.

ID

Integer

A value that uniquely identifies the column.

IdentificationString

String

A string that identifies the column.

Name

String

The name of the external column.

External metadata columns also include a set of data type properties.

Data Type Properties

Output columns and external metadata columns include a set of data type properties. Depending on the data type of the column, properties can be read/write or read-only.

The following table describes the data type properties of output columns and external metadata columns.

Property Data Type Description

CodePage

Integer

Specifies the code page for string data that is not Unicode.

DataType

Integer (enumeration)

The Integration Services data type of the column. For more information, see Integration Services 資料類型.

Length

Integer

The length, measured in characters, of a column.

Precision

Integer

The precision of a numeric column.

Scale

Integer

The scale of a numeric column.

Change History

Release History

2006 年 4 月 14 日

Changed content:
  • Input and Output Properties. Improved description of HasSideEffects property.

2005 年 12 月 5 日

Changed content:
  • Component Properties. Added ID, IdentificationString, and IsDefaultLocale properties.
  • Input Properties. Removed Dangling property. Added ID, IdentificationString, IsSorted, and SourceLocale properties.
  • Input Column Properties. Added ComparisonFlags, ID, IdentificationString, LineageID, SortKeyPosition, and UpstreamComponentName properties.
  • Output Properties. Removed Dangling, MaxDownstreamConcurrency, and PreserveOrdering properties. Added ID and IdentificationString properties.
  • Output Column Properties. Added ID, IdentificationString, and LineageID properties.
  • External Metadata Column Properties. Added ID and IdentificationString properties.

請參閱

參考

Source Custom Properties
Transformation Custom Properties
Destination Custom Properties
Path Properties

概念

Using Property Expressions to Specify Property Values for Data Flow Objects

其他資源

資料流程元素

說明及資訊

取得 SQL Server 2005 協助