共用方式為


通用屬性

Microsoft SQL Server Integration Services 物件模型中的資料流程物件具有元件層級、輸入和輸出層級,以及輸入資料行和輸出資料行層級上的通用屬性和自訂屬性。許多屬性都有唯讀的值,這些值是在執行階段由資料流程引擎所指派。

本主題將列出及描述資料流程物件的通用屬性。

  • 元件

  • 輸入

  • 輸入資料行

  • 輸出

  • 輸出資料行

元件屬性

在 Integration Services 物件模型中,資料流程中的元件會實作 IDTSComponentMetaData100 介面。

下表將描述資料流程中的元件屬性。某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。

屬性

資料類型

描述

ComponentClassID

字串

元件的 CLSID。

ContactInfo

字串

元件開發人員的連絡資訊。

Description

字串

資料流程元件的描述。這個屬性的預設值為資料流程元件的名稱。

ID

整數

可唯一識別這個元件執行個體的值。

IdentificationString

字串

識別此元件。

IsDefaultLocale

布林

指示元件是否使用其所屬之資料流程工作的地區設定。

LocaleID

整數

當封裝執行時,資料流程元件所使用的地區設定。所有的 Windows 地區設定都可用於資料流程元件。

Name

字串

資料流程元件的名稱。

PipelineVersion

整數

專門用來執行元件的資料流程工作版本。

UsesDispositions

布林

指示元件是否有錯誤輸出。

ValidateExternalMetadata

布林

指示是否會驗證外部資料行的中繼資料。此屬性的預設值為 True。

Version

整數

元件的版本。

輸入屬性

在 Integration Services 物件模型中,轉換和目的地都有輸入。資料流程中元件的輸入會實作 IDTSInput100 介面。

下表將描述資料流程中元件輸入的屬性。某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。

屬性

資料類型

描述

Description

字串

輸入的描述。

ErrorOrTruncationOperation

字串

指定處理資料列時發生之錯誤或截斷類型的選擇性字串。

ErrorRowDisposition

DTSRowDisposition

指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。

HasSideEffects

布林

指示當元件未附加到下游元件以及當 RunInOptimizedMode 為 true 時,是否可以從資料流程的執行計畫中移除此元件。

ID

整數

可唯一識別輸入的值。

IdentificationString

字串

識別輸入的字串。

IsSorted

布林

指示是否要排序輸入中的資料。

Name

字串

輸入的名稱。

SourceLocale

整數

輸入資料的地區設定識別碼 (LCID)。

TruncationRowDisposition

DTSRowDisposition

決定元件如何處理當處理資料列時發生之截斷的值。. 這些值為 Fail component、Ignore failure 和 Redirect row。

目的地和某些轉換不支援錯誤輸出,而且這些元件的 ErrorRowDispositionTruncationRowDisposition 屬性是唯讀的。

輸入資料行屬性

在 Integration Services 物件模型中,輸入包含輸入資料行的集合。資料流程中元件的輸入資料行會實作 IDTSInputColumn100 介面。

下表將描述資料流程中元件輸入資料行的屬性。某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。

屬性

資料類型

描述

ComparisonFlags

整數

指定具有字元資料類型之資料行比較的一組旗標。如需詳細資訊,請參閱<比較字串資料>。

Description

字串

描述輸入資料行。

ErrorOrTruncationOperation

字串

指定處理資料列時發生之錯誤或截斷類型的選擇性字串。

ErrorRowDisposition

DTSRowDisposition

指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。

ExternalMetadataColumnID

IDTSExternalMetadataColumn100

指派給輸入資料行之外部中繼資料行的識別碼。

ID

整數

可唯一識別輸入資料行的值。

IdentificationString

字串

識別輸入資料行的字串。

LineageID

整數

上游資料行的識別碼。

Name

字串

輸入資料行的名稱。

SortKeyPosition

整數

指示是否排序資料行、其排序次序以及排序多個資料行之順序的值。值為 0 時,表示資料行並未排序。如需詳細資訊,請參閱<如何:排序合併和合併聯結轉換的資料>。

TruncationRowDisposition

DTSRowDisposition

決定元件如何處理當處理資料列時發生之截斷的值。這些值為 Fail component、Ignore failure 和 Redirect row。

UpstreamComponentName

字串

上游元件的名稱。

UsageType

DTSUsageType

決定元件如何使用輸入資料行的值。

輸入資料行也具有資料類型屬性 (如「資料類型屬性」底下所述)。

輸出屬性

在 Integration Services 物件模型中,來源和轉換都有輸出。資料流程中元件的輸出會實作 IDTSOutput100 介面。

下表將描述資料流程中元件輸出的屬性。某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。

屬性

資料類型

描述

DeleteOutputOnPathDetached

布林

決定當從路徑中卸離輸出時,資料流程引擎是否要刪除輸出的值。

Description

字串

描述輸出。

ErrorOrTruncationOperation

字串

指定處理資料列時發生之錯誤或截斷類型的選擇性字串。

ErrorRowDisposition

DTSRowDisposition

指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。

ExclusionGroup

整數

識別一組互斥輸出的值。

HasSideEffects

布林

指示當元件未附加到上游元件以及當 RunInOptimizedMode 為 true 時,是否可以從資料流程的執行計畫中移除此元件的值。

ID

整數

可唯一識別輸出的值。

IdentificationString

字串

識別輸出的字串。

IsErrorOut

布林

指示輸出是否為錯誤輸出。

IsSorted

布林

指示是否要排序輸出。預設值為 False。

重要事項重要事項
將 IsSorted 屬性的值設定為 True 時,不會排序資料。此屬性僅針對資料先前已經過排序的下游元件提供提示。如需詳細資訊,請參閱<如何:排序合併和合併聯結轉換的資料>。

Name

字串

輸出的名稱。

SynchronousInputID

整數

與輸出同步之輸入的識別碼。

TruncationRowDisposition

DTSRowDisposition

決定元件如何處理當處理資料列時發生之截斷的值。這些值為 Fail component、Ignore failure 和 Redirect row。

輸出資料行屬性

在 Integration Services 物件模型中,輸出包含輸出資料行的集合。資料流程中元件的輸出資料行會實作 IDTSOutputColumn100 介面。

下表將描述資料流程中元件輸出資料行的屬性。某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。

屬性

資料類型

描述

ComparisonFlags

整數

指定具有字元資料類型之資料行比較的一組旗標。如需詳細資訊,請參閱<比較字串資料>。

Description

字串

描述輸出資料行。

ErrorOrTruncationOperation

字串

指定處理資料列時發生之錯誤或截斷類型的選擇性字串。

ErrorRowDisposition

DTSRowDisposition

指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。預設值為 Fail component

ExternalMetadataColumnID

整數

指派給輸入資料行之外部中繼資料行的識別碼。

ID

整數

可唯一識別輸出資料行的值。

IdentificationString

字串

識別輸出資料行的字串。

LineageID

整數

輸出資料行的識別碼。下游元件會使用這個值來參考此資料行。

Name

字串

輸出資料行的名稱。

SortKeyPosition

整數

指示是否排序資料行、其排序次序以及排序多個資料行之順序的值。當這個值為 0 時,表示資料行並未排序。如需詳細資訊,請參閱<如何:排序合併和合併聯結轉換的資料>。

SpecialFlags

整數

包含輸出資料行之特殊旗標的值。

TruncationRowDisposition

DTSRowDisposition

決定元件如何處理當處理資料列時發生之截斷的值。這些值為 Fail component、Ignore failure 和 Redirect row。預設值為 Fail component

輸出資料行也包含一組資料類型屬性。

外部中繼資料行屬性

在 Integration Services 物件模型中,輸入和輸出都可以包含外部中繼資料行的集合。資料流程中元件的外部中繼資料行會實作 IDTSExternalMetadataColumn100 介面。

下表將描述資料流程中元件之外部中繼資料行的屬性。某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。

屬性

資料類型

描述

Description

字串

描述外部資料行。

ID

整數

可唯一識別此資料行的值。

IdentificationString

字串

識別此資料行的字串。

Name

字串

外部資料行的名稱。

外部中繼資料行也包含一組資料類型屬性。

資料類型屬性

輸出資料行和外部中繼資料行也包含一組資料類型屬性。根據此資料行的資料類型而定,屬性可以是可讀寫或唯讀。

下表將描述輸出資料行和外部中繼資料行的資料類型屬性。

屬性

資料類型

描述

CodePage

整數

指定字串資料的字碼頁不是 Unicode。

DataType

整數 (列舉)

此資料行的 Integration Services 資料類型。如需詳細資訊,請參閱<Integration Services 資料類型>。

Length

整數

資料行的長度 (以字元為測量單位)。

Precision

整數

數值資料行的有效位數。

Scale

整數

數值資料行的小數位數。