通用屬性
MicrosoftSQL ServerIntegration 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 |
指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。 |
|
HasSideEffects |
布林 |
指示當元件未附加到下游元件以及當 RunInOptimizedMode 為 true 時,是否可以從資料流程的執行計畫中移除此元件。 |
ID |
整數 |
可唯一識別輸入的值。 |
IdentificationString |
字串 |
識別輸入的字串。 |
IsSorted |
布林 |
指示是否要排序輸入中的資料。 |
Name |
字串 |
輸入的名稱。 |
SourceLocale |
整數 |
輸入資料的地區設定識別碼 (LCID)。 |
TruncationRowDisposition |
決定元件如何處理當處理資料列時發生之截斷的值。. 這些值為 Fail component、Ignore failure 和 Redirect row。 |
目的地和某些轉換不支援錯誤輸出,而且這些元件的 ErrorRowDisposition 和 TruncationRowDisposition 屬性是唯讀的。
輸入資料行屬性
在 Integration Services 物件模型中,輸入包含輸入資料行的集合。資料流程中元件的輸入資料行會實作 IDTSInputColumn100 介面。
下表將描述資料流程中元件輸入資料行的屬性。某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
屬性 |
資料類型 |
描述 |
---|---|---|
ComparisonFlags |
整數 |
指定具有字元資料類型之資料行比較的一組旗標。如需詳細資訊,請參閱<比較字串資料>。 |
Description |
字串 |
描述輸入資料行。 |
ErrorOrTruncationOperation |
字串 |
指定處理資料列時發生之錯誤或截斷類型的選擇性字串。 |
ErrorRowDisposition |
指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。 |
|
ExternalMetadataColumnID |
指派給輸入資料行之外部中繼資料行的識別碼。 |
|
ID |
整數 |
可唯一識別輸入資料行的值。 |
IdentificationString |
字串 |
識別輸入資料行的字串。 |
LineageID |
整數 |
上游資料行的識別碼。 |
Name |
字串 |
輸入資料行的名稱。 |
SortKeyPosition |
整數 |
指示是否排序資料行、其排序次序以及排序多個資料行之順序的值。值為 0 時,表示資料行並未排序。如需詳細資訊,請參閱<如何:排序合併和合併聯結轉換的資料>。 |
TruncationRowDisposition |
決定元件如何處理當處理資料列時發生之截斷的值。這些值為 Fail component、Ignore failure 和 Redirect row。 |
|
UpstreamComponentName |
字串 |
上游元件的名稱。 |
UsageType |
決定元件如何使用輸入資料行的值。 |
輸入資料行也具有資料類型屬性 (如「資料類型屬性」底下所述)。
輸出屬性
在 Integration Services 物件模型中,來源和轉換都有輸出。資料流程中元件的輸出會實作 IDTSOutput100 介面。
下表將描述資料流程中元件輸出的屬性。某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
屬性 |
資料類型 |
描述 |
---|---|---|
DeleteOutputOnPathDetached |
布林 |
決定當從路徑中卸離輸出時,資料流程引擎是否要刪除輸出的值。 |
Description |
字串 |
描述輸出。 |
ErrorOrTruncationOperation |
字串 |
指定處理資料列時發生之錯誤或截斷類型的選擇性字串。 |
ErrorRowDisposition |
指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。 |
|
ExclusionGroup |
整數 |
識別一組互斥輸出的值。 |
HasSideEffects |
布林 |
指示當元件未附加到上游元件以及當 RunInOptimizedMode 為 true 時,是否可以從資料流程的執行計畫中移除此元件的值。 |
ID |
整數 |
可唯一識別輸出的值。 |
IdentificationString |
字串 |
識別輸出的字串。 |
IsErrorOut |
布林 |
指示輸出是否為錯誤輸出。 |
IsSorted |
布林 |
指示是否要排序輸出。預設值為 False。
重要事項
將 IsSorted 屬性的值設定為 True 時,不會排序資料。此屬性僅針對資料先前已經過排序的下游元件提供提示。如需詳細資訊,請參閱<如何:排序合併和合併聯結轉換的資料>。
|
Name |
字串 |
輸出的名稱。 |
SynchronousInputID |
整數 |
與輸出同步之輸入的識別碼。 |
TruncationRowDisposition |
決定元件如何處理當處理資料列時發生之截斷的值。這些值為 Fail component、Ignore failure 和 Redirect row。 |
輸出資料行屬性
在 Integration Services 物件模型中,輸出包含輸出資料行的集合。資料流程中元件的輸出資料行會實作 IDTSOutputColumn100 介面。
下表將描述資料流程中元件輸出資料行的屬性。某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
屬性 |
資料類型 |
描述 |
---|---|---|
ComparisonFlags |
整數 |
指定具有字元資料類型之資料行比較的一組旗標。如需詳細資訊,請參閱<比較字串資料>。 |
Description |
字串 |
描述輸出資料行。 |
ErrorOrTruncationOperation |
字串 |
指定處理資料列時發生之錯誤或截斷類型的選擇性字串。 |
ErrorRowDisposition |
指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。預設值為 Fail component。 |
|
ExternalMetadataColumnID |
整數 |
指派給輸入資料行之外部中繼資料行的識別碼。 |
ID |
整數 |
可唯一識別輸出資料行的值。 |
IdentificationString |
字串 |
識別輸出資料行的字串。 |
LineageID |
整數 |
輸出資料行的識別碼。下游元件會使用這個值來參考此資料行。 |
Name |
字串 |
輸出資料行的名稱。 |
SortKeyPosition |
整數 |
指示是否排序資料行、其排序次序以及排序多個資料行之順序的值。當這個值為 0 時,表示資料行並未排序。如需詳細資訊,請參閱<如何:排序合併和合併聯結轉換的資料>。 |
SpecialFlags |
整數 |
包含輸出資料行之特殊旗標的值。 |
TruncationRowDisposition |
決定元件如何處理當處理資料列時發生之截斷的值。這些值為 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 |
整數 |
數值資料行的小數位數。 |