通用屬性
Microsoft SQL Server Integration Services 物件模型中的資料流程物件具有元件層級、輸入和輸出層級,以及輸入資料行和輸出資料行層級的通用屬性和自訂屬性。 許多屬性都有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
本主題將列出及描述資料流程物件的通用屬性。
如需有關客戶屬性的詳細資訊,請參閱下列主題
OLE DB 自訂屬性OLE DB 自訂屬性
元件屬性
在 Integration Services 物件模型中,資料流程的元件會實作 IDTSComponentMetaData100 介面。
下表將描述資料流程中的元件屬性。 某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
屬性 | 資料類型 | 描述 |
---|---|---|
ComponentClassID | String | 元件的 CLSID。 |
ContactInfo | String | 元件開發人員的連絡資訊。 |
描述 | String | 資料流程元件的描述。 這個屬性的預設值為資料流程元件的名稱。 |
ID | 整數 | 可唯一識別這個元件執行個體的值。 |
IdentificationString | String | 識別此元件。 |
IsDefaultLocale | 布林值 | 指示元件是否使用其所屬之資料流程工作的地區設定。 |
LocaleID | 整數 | 當封裝執行時,資料流程元件所使用的地區設定。 所有的 Windows 地區設定都可用於資料流程元件。 |
Name | String | 資料流程元件的名稱。 |
PipelineVersion | 整數 | 專門用來執行元件的資料流程工作版本。 |
UsesDispositions | 布林值 | 指示元件是否有錯誤輸出。 |
ValidateExternalMetadata | Boolean | 指示是否會驗證外部資料行的中繼資料。 此屬性的預設值為 True 。 |
版本 | 整數 | 元件的版本。 |
輸入屬性
在 Integration Services 物件模型中,轉換和目的地都有輸入。 資料流程中元件的輸入會實作 IDTSInput100 介面。
下表將描述資料流程中元件輸入的屬性。 某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
屬性 | 資料類型 | 描述 |
---|---|---|
描述 | String | 輸入的描述。 |
ErrorOrTruncationOperation | String | 指定處理資料列時發生之錯誤或截斷類型的選擇性字串。 |
ErrorRowDisposition | DTSRowDisposition | 指定錯誤處理的值。 這些值為 Fail component 、Ignore failure 和 Redirect row 。 |
HasSideEffects | 布林值 | 指出當元件未附加至下游元件,以及 當 RunInOptimizedMode true 為 時,是否可以從資料流程的執行計畫中移除該元件。 |
ID | 整數 | 可唯一識別輸入的值。 |
IdentificationString | String | 識別輸入的字串。 |
IsSorted | 布林值 | 指示是否要排序輸入中的資料。 |
Name | String | 輸入的名稱。 |
SourceLocale | 整數 | 輸入資料的地區設定識別碼 (LCID)。 |
TruncationRowDisposition | DTSRowDisposition | 決定元件如何處理當處理資料列時發生之截斷的值。 . 這些值為 Fail component 、Ignore failure 和 Redirect row 。 |
目的地和某些轉換不支援錯誤輸出,而且這些元件的 ErrorRowDisposition 和 TruncationRowDisposition 屬性是唯讀的。
輸入資料行屬性
在 Integration Services 物件模型中,輸入包含輸入資料行的集合。 資料流程中元件的輸入資料行會實作 IDTSInputColumn100 介面。
下表將描述資料流程中元件輸入資料行的屬性。 某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
屬性 | 資料類型 | 描述 |
---|---|---|
ComparisonFlags | 整數 | 指定具有字元資料類型之資料行比較的一組旗標。 如需詳細資訊,請參閱 Comparing String Data。 |
描述 | String | 描述輸入資料行。 |
ErrorOrTruncationOperation | String | 指定處理資料列時發生之錯誤或截斷類型的選擇性字串。 |
ErrorRowDisposition | DTSRowDisposition | 指定錯誤處理的值。 這些值為 Fail component 、Ignore failure 和 Redirect row 。 |
ExternalMetadataColumnID | IDTSExternalMetadataColumn100 | 指派給輸入資料行之外部中繼資料行的識別碼。 |
ID | 整數 | 可唯一識別輸入資料行的值。 |
IdentificationString | String | 識別輸入資料行的字串。 |
LineageID | 整數 | 上游資料行的識別碼。 |
名稱 | String | 輸入資料行的名稱。 |
SortKeyPosition | 整數 | 指示是否排序資料行、其排序次序以及排序多個資料行之順序的值。 值為 0 時,指出資料行並未排序。 如需詳細資訊,請參閱 排序合併和合併聯結轉換的資料。 |
TruncationRowDisposition | DTSRowDisposition | 決定元件如何處理當處理資料列時發生之截斷的值。 這些值為 Fail component 、Ignore failure 和 Redirect row 。 |
UpstreamComponentName | String | 上游元件的名稱。 |
UsageType | DTSUsageType | 決定元件如何使用輸入資料行的值。 |
輸入資料行也具有資料類型屬性 (如「資料類型屬性」底下所述)。
輸出屬性
在 Integration Services 物件模型中,來源和轉換都有輸出。 資料流程中元件的輸出會實作 IDTSOutput100 介面。
下表將描述資料流程中元件輸出的屬性。 某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
屬性 | 資料類型 | 描述 |
---|---|---|
DeleteOutputOnPathDetached | 布林值 | 決定當從路徑中卸離輸出時,資料流程引擎是否要刪除輸出的值。 |
描述 | String | 描述輸出。 |
ErrorOrTruncationOperation | String | 指定處理資料列時發生之錯誤或截斷類型的選擇性字串。 |
ErrorRowDisposition | DTSRowDisposition | 指定錯誤處理的值。 這些值為 Fail component 、Ignore failure 和 Redirect row 。 |
ExclusionGroup | 整數 | 識別一組互斥輸出的值。 |
HasSideEffects | 布林值 | 指示當元件未附加到上游元件以及當 RunInOptimizedMode 為 true 時,是否可以從資料流程的執行計畫中移除此元件的值‧ |
ID | 整數 | 可唯一識別輸出的值。 |
IdentificationString | String | 識別輸出的字串。 |
IsErrorOut | 布林值 | 指示輸出是否為錯誤輸出。 |
IsSorted | 布林值 | 指示是否要排序輸出。 預設值是 False 。**重要** 將 屬性的值 IsSorted 設定為 True 不會排序資料。 此屬性僅針對資料先前已經過排序的下游元件提供提示。 如需詳細資訊,請參閱 排序合併和合併聯結轉換的資料。 |
Name | String | 輸出的名稱。 |
SynchronousInputID | 整數 | 與輸出同步之輸入的識別碼。 |
TruncationRowDisposition | DTSRowDisposition | 決定元件如何處理當處理資料列時發生之截斷的值。 這些值為 Fail component 、Ignore failure 和 Redirect row 。 |
輸出資料行屬性
在 Integration Services 物件模型中,輸出包含輸出資料行的集合。 資料流程中元件的輸出資料行會實作 IDTSOutputColumn100 介面。
下表將描述資料流程中元件輸出資料行的屬性。 某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
屬性 | 資料類型 | 描述 |
---|---|---|
ComparisonFlags | 整數 | 指定具有字元資料類型之資料行比較的一組旗標。 如需詳細資訊,請參閱 Comparing String Data。 |
描述 | String | 描述輸出資料行。 |
ErrorOrTruncationOperation | String | 指定處理資料列時發生之錯誤或截斷類型的選擇性字串。 |
ErrorRowDisposition | DTSRowDisposition | 指定錯誤處理的值。 這些值為 Fail component 、Ignore failure 和 Redirect row 。 預設值是 Fail component 。 |
ExternalMetadataColumnID | 整數 | 指派給輸入資料行之外部中繼資料行的識別碼。 |
ID | 整數 | 可唯一識別輸出資料行的值。 |
IdentificationString | String | 識別輸出資料行的字串。 |
LineageID | 整數 | 輸出資料行的識別碼。 下游元件會使用這個值來參考此資料行。 |
名稱 | String | 輸出資料行的名稱。 |
SortKeyPosition | 整數 | 指示是否排序資料行、其排序次序以及排序多個資料行之順序的值。 值為 0 時,指出資料行並未排序。 如需詳細資訊,請參閱 排序合併和合併聯結轉換的資料。 |
SpecialFlags | 整數 | 包含輸出資料行之特殊旗標的值。 |
TruncationRowDisposition | DTSRowDisposition | 決定元件如何處理當處理資料列時發生之截斷的值。 這些值為 Fail component 、Ignore failure 和 Redirect row 。 預設值是 Fail component 。 |
輸出資料行也包含一組資料類型屬性。
外部中繼資料行屬性
在 Integration Services 物件模型中,輸入和輸出都可以包含外部中繼資料行的集合。 資料流程中元件的外部中繼資料行會實作 IDTSExternalMetadataColumn100 介面。
下表將描述資料流程中元件之外部中繼資料行的屬性。 某些屬性具有唯讀的值,這些值是在執行階段由資料流程引擎所指派。
屬性 | 資料類型 | 描述 |
---|---|---|
描述 | String | 描述外部資料行。 |
ID | 整數 | 可唯一識別此資料行的值。 |
IdentificationString | String | 識別此資料行的字串。 |
Name | String | 外部資料行的名稱。 |
外部中繼資料行也包含一組資料類型屬性。
資料類型屬性
輸出資料行和外部中繼資料行也包含一組資料類型屬性。 根據此資料行的資料類型而定,屬性可以是可讀寫或唯讀。
下表將描述輸出資料行和外部中繼資料行的資料類型屬性。
屬性 | 資料類型 | 描述 |
---|---|---|
CodePage | 整數 | 指定字串資料的字碼頁不是 Unicode。 |
DataType | 整數 (列舉) | Integration Services 的資料行資料類型。 如需詳細資訊,請參閱 Integration Services 資料類型。 |
長度 | 整數 | 資料行的長度 (以字元為測量單位)。 |
精確度 | 整數 | 數值資料行的有效位數。 |
調整 | 整數 | 數值資料行的小數位數。 |