設定資料流程元件的屬性

適用於：SQL Server Azure Data Factory 的 SSIS Integration Runtime

若要設定資料流程元件的屬性 (包括來源、目的地和轉換)，請使用下列其中一個功能：

  • Integration Services 提供的元件編輯器。 這些編輯器僅包括每個資料流程元件的自訂屬性。

  • [屬性] 視窗會列出每個元素的元件層級自訂屬性，以及所有資料流程元素通用的屬性。

  • [進階編輯器] 對話方塊可讓您存取每一個元件的自訂屬性。 [進階編輯器] 對話方塊也可讓您存取所有資料流程元件的屬性，也就是輸入、輸出、錯誤輸出、資料行和外部資料行的屬性。

使用元件編輯器設定資料流程元件的屬性

  1. 在 SQL Server Data Tools (SSDT) 中，開啟包含您所需套件的 Integration Services 專案。

  2. 在 [方案總管] 中，按兩下套件即可開啟。

  3. 按一下 [控制流程] 索引標籤，然後按兩下包含資料流程 (具有您要檢視及修改其屬性之元件) 的「資料流程」工作。

  4. 按兩下資料流程元件。

  5. 在元件編輯器中，檢視或修改屬性值，然後關閉編輯器。

  6. 若要儲存已更新的封裝，請按一下 [檔案] 功能表上的 [儲存選取項目] 。

在屬性視窗中設定資料流程元件的屬性

  1. 在 SQL Server Data Tools (SSDT) 中，開啟包含您所需套件的 Integration Services 專案。

  2. 在 [方案總管] 中，按兩下套件即可開啟。

  3. 按一下 [控制流程] 索引標籤，然後按兩下包含您要檢視及修改其屬性之元件的「資料流程」工作。

  4. 以滑鼠右鍵按一下資料流程元件，然後按一下 [屬性]。

  5. 檢視或修改屬性值，然後關閉 [屬性] 視窗。

    注意

    許多屬性都是唯讀的，因此無法修改。

  6. 若要儲存已更新的封裝，請按一下 [檔案] 功能表上的 [儲存選取項目] 。

使用進階編輯器設定資料流程元件的屬性

  1. 在 SQL Server Data Tools (SSDT) 中，開啟包含您所需套件的 Integration Services 專案。

  2. 在 [方案總管] 中，按兩下套件即可開啟。

  3. 按一下 控制流程 索引標籤，然後按兩下內含您要檢視或修改之元件的 [資料流程] 工作。

  4. 在資料流程設計師中，以滑鼠右鍵按一下資料流程元件，然後按一下 [顯示進階編輯器]。

    注意

    在 SQL Server 中，支援多個輸入的資料流程元件無法使用 [進階編輯器]。

  5. 在 [進階編輯器] 對話方塊中，執行下列任何一個步驟：

    • 若要檢視及指定此元件所使用的連接，請按一下 [連線管理員] 索引標籤。

      注意

      [連線管理員] 索引標籤只可用於使用連線管理員連接到資料來源 (例如檔案和資料庫) 的資料流程元件

    • 若要檢視和修改元件層級屬性，請按一下 [元件屬性] 索引標籤。

    • 若要檢視和修改外部資料行與可用輸出之間的對應，請按一下 [資料行對應] 索引標籤。

      注意

      資料行對應索引標籤頁僅在檢視或編輯來源或目的地時可用。

    • 若要檢視可用輸入資料行的清單並更新輸出資料行的名稱，請按一下 [輸入資料行] 索引標籤。

      注意

      [輸入資料行] 索引標籤僅在使用轉換或目的地時可用。 如需詳細資訊，請參閱 Integration Services 轉換。

    • 若要檢視和修改輸入、輸出及錯誤輸出的屬性，以及檢視和修改其包含之資料行的屬性，請按一下 [輸入與輸出屬性] 索引標籤。

      注意

      來源沒有任何輸入。 除了選擇性的錯誤輸出之外，目的地沒有輸出。

  6. 檢視或修改屬性值。

  7. 按一下 [確定] 。

  8. 若要儲存已更新的封裝，請按一下 [檔案] 功能表上的 [儲存選取項目] 。

資料流程元件的通用屬性

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

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

元件屬性

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

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

屬性 資料類型 描述
ComponentClassID 字串 元件的 CLSID。
聯絡資訊 字串 元件開發人員的連絡資訊。
描述 字串 資料流程元件的描述。 這個屬性的預設值為資料流程元件的名稱。
ID 整數 可唯一識別此元件執行個體的值。
識別字串 字串 識別此元件。
IsDefaultLocale 布林值 指示元件是否使用其所屬之資料流程工作的地區設定。
LocaleID 整數 封裝執行時，資料流程元件所使用的地區設定。 所有的 Windows 地區設定都可用於資料流程元件。
Name 字串 資料流程元件的名稱。
管線版本 整數 專門用來執行元件的資料流程工作版本。
用途與配置 布林值 指示元件是否有錯誤輸出。
ValidateExternalMetadata 布林值 指示是否會驗證外部資料行的中繼資料。 這個屬性的預設值為 True。
版本 整數 元件的版本。

輸入屬性

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

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

屬性 資料類型 描述
描述 字串 輸入內容的描述。
錯誤或截斷作業 字串 指定處理資料列時可能發生的錯誤或截斷類型的選擇性字串。
ErrorRowDisposition DTSRowDisposition 指定錯誤處理的值。 這些值包括 [失敗元件]、[忽略失敗] 和 [重新導向資料列]。
具有副作用 布林值 指示當元件未附加到下游元件以及當 RunInOptimizedMode 為 true時，是否可以從資料流程的執行計畫中移除此元件。
ID 整數 用來唯一識別輸入的值。
識別字串 字串 用來識別輸入內容的字串。
IsSorted 布林值 指示是否要排序輸入中的資料。
Name 字串 輸入的名稱。
SourceLocale 整數 輸入資料的地區設定識別碼 (LCID)。
截斷資料列處理方式 DTSRowDisposition 決定元件在處理資料列時如何處理發生的截斷情況的值。 . 這些值包括 [失敗元件]、[忽略失敗] 和 [重新導向資料列]。

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

輸入資料行屬性

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

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

屬性 資料類型 描述
ComparisonFlags 整數 指定具有字元資料類型之資料行比較方式的一組旗標。 如需詳細資訊，請參閱 Comparing String Data。
描述 字串 描述輸入資料行。
錯誤或截斷作業 字串 指定處理資料列時可能發生的錯誤或截斷類型的選擇性字串。
ErrorRowDisposition DTSRowDisposition 指定錯誤處理的值。 這些值包括 [失敗元件]、[忽略失敗] 和 [重新導向資料列]。
ExternalMetadataColumnID IDTSExternalMetadataColumn100 指派給輸入資料行的外部中繼資料資料行識別碼。
ID 整數 可用來唯一識別輸入資料行的值。
識別字串 字串 用來識別輸入資料行的字串。
LineageID 整數 上游資料行的識別碼。
譜系識別字串 字串 包含上游資料行名稱的識別字串。
Name 字串 輸入資料行的名稱。
排序鍵位置 整數 指出資料行是否已排序、其排序次序，以及多個資料行排序時先後順序的值。 值為 0 時，指出資料行並未排序。 如需詳細資訊，請參閱 排序合併和合併聯結轉換的資料。
截斷資料列處理方式 DTSRowDisposition 決定元件在處理資料列時如何處理發生的截斷情況的值。 這些值包括 [失敗元件]、[忽略失敗] 和 [重新導向資料列]。
UpstreamComponentName 字串 上游元件的名稱。
使用類型 DTSUsageType 決定元件如何使用輸入資料行的值。

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

輸出屬性

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

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

屬性 資料類型 描述
路徑分離時刪除輸出 布林值 決定當輸出與路徑分離時，資料流程引擎是否刪除該輸出的值。
描述 字串 描述輸出。
錯誤或截斷作業 字串 指定處理資料列時可能發生的錯誤或截斷類型的選擇性字串。
ErrorRowDisposition DTSRowDisposition 指定錯誤處理的值。 這些值包括 [失敗元件]、[忽略失敗] 和 [重新導向資料列]。
排除群組 整數 用來識別一組彼此互斥輸出的值。
具有副作用 布林值 表示當元件未連接到上游元件，且 RunInOptimizedMode 為 true 時，是否可以將該元件從資料流程的執行計畫中移除的值。
ID 整數 用來唯一識別輸出的值。
識別字串 字串 識別輸出的字串。
IsErrorOut 布林值 指示輸出是否為錯誤輸出。
IsSorted 布林值 指示是否要排序輸出。 預設值為 [False] 。

重要事項：將 IsSorted 屬性的值設定為 True 時，不會排序資料。 此屬性僅針對資料先前已經過排序的下游元件提供提示。 如需詳細資訊，請參閱 排序合併和合併聯結轉換的資料。
Name 字串 輸出的名稱。
SynchronousInputID 整數 與輸出同步之輸入的識別碼。
截斷資料列處理方式 DTSRowDisposition 決定元件在處理資料列時如何處理發生的截斷情況的值。 這些值包括 [失敗元件]、[忽略失敗] 和 [重新導向資料列]。

輸出資料行屬性

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

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

屬性 資料類型 描述
ComparisonFlags 整數 指定具有字元資料類型之資料行比較方式的一組旗標。 如需詳細資訊，請參閱 Comparing String Data。
描述 字串 描述輸出資料行。
錯誤或截斷作業 字串 指定處理資料列時可能發生的錯誤或截斷類型的選擇性字串。
ErrorRowDisposition DTSRowDisposition 指定錯誤處理的值。 這些值包括 [失敗元件]、[忽略失敗] 和 [重新導向資料列]。 預設值為 [失敗元件]。
ExternalMetadataColumnID 整數 指派給輸入資料行的外部中繼資料資料行識別碼。
ID 整數 可唯一識別輸出資料行的值。
識別字串 字串 用來識別輸出資料行的字串。
LineageID 整數 輸出資料行的識別碼。 下游元件會使用這個值來參照該資料行。
譜系識別字串 字串 包含資料行名稱的識別字串。
Name 字串 輸出資料行的名稱。
排序鍵位置 整數 指出資料行是否已排序、其排序次序，以及多個資料行排序時先後順序的值。 值為 0 時，指出資料行並未排序。 如需詳細資訊，請參閱 排序合併和合併聯結轉換的資料。
特殊旗標 整數 包含輸出資料行特殊旗標的值。
截斷資料列處理方式 DTSRowDisposition 決定元件在處理資料列時如何處理發生的截斷情況的值。 這些值包括 [失敗元件]、[忽略失敗] 和 [重新導向資料列]。 預設值為 [失敗元件]。

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

外部中繼資料資料行屬性

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

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

屬性 資料類型 描述
描述 字串 描述外部資料行。
ID 整數 唯一識別此資料行的值。
識別字串 字串 用來識別此資料行的字串。
Name 字串 外部資料行的名稱。

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

資料類型屬性

輸出資料行和外部中繼資料行也包含一組資料類型屬性。 視資料行的資料類型而定，屬性可為可讀寫或唯讀。

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

屬性 資料類型 描述
CodePage 整數 指定非 Unicode 字串資料的字碼頁。
資料類型 整數 (列舉) Integration Services 的資料行資料類型。 如需詳細資訊，請參閱 Integration Services 資料類型。
長度 整數 資料欄的長度，以字元為單位。
精確度 整數 數值資料行的有效位數。
縮放 整數 數值資料行的小數位數。

資料流程元件的自訂屬性

如需自訂屬性的資訊，請參閱下列主題

在資料流程元件中使用運算式

本程序說明如何將運算式新增至「條件式分割」轉換或「衍生資料行」轉換。 「條件式分割」轉換會使用運算式，定義將資料列導向轉換輸出的條件，而「衍生的資料行」轉換則使用運算式，定義指派給資料行的值。

若要在轉換中實作運算式，套件必須已至少包含一個「資料流程」工作以及一個來源。

  1. 在 SQL Server Data Tools (SSDT) 中，開啟包含您所需套件的 Integration Services 專案。

  2. 在 [方案總管] 中，按兩下套件即可開啟。

  3. 在 SSIS Designer 中，按一下 Control Flow 索引標籤，然後按一下包含您要在其中實作運算式之資料流程的資料流程工作。

  4. 按一下資料流程索引標籤，然後從工具箱將「條件式分割」或「衍生資料行」轉換拖曳到設計介面。

  5. 將綠色連接器從來源或某個轉換拖曳到「條件式分割」或「衍生資料行」轉換。

  6. 按兩下轉換，以開啟其對話方塊。

  7. 在左窗格中，展開 [變數]，以顯示系統變數和使用者自訂變數，並展開 [資料行]，以顯示轉換輸入資料行。

  8. 在右窗格中，展開 [數學函數]、[字串函數]、[日期/時間函數]、[NULL 函數]、[類型轉換] 和 [運算子]，以存取運算式文法所提供的函數、轉換和運算子。

  9. 視轉換而定，請執行下列其中一項來建立運算式：

    • 在 [條件式分割轉換編輯器] 對話方塊中，將變數、資料行、函數、運算子和轉換拖曳至 [條件] 資料行。 您也可以在 [條件] 資料行中直接鍵入運算式。

    • 在 [衍生的資料行轉換編輯器] 對話方塊中，將變數、資料行、函數、運算子和轉換拖曳至 [運算式] 資料行。 或者，您可以直接在 運算式 欄中輸入運算式。

      注意

      從 [條件] 資料行或 [運算式] 資料行移除焦點時，運算式文字可能會反白顯示，指示運算式語法不正確。

  10. 按一下 [確定]，結束對話方塊。

    注意

    如果運算式無效，則會出現警示，描述運算式中的語法錯誤。

可使用運算式設定的資料流程屬性

可使用「資料流程」工作容器上提供的屬性運算式，以指定資料流程物件的某些屬性值。

如需使用屬性運算式的資訊，請參閱 在封裝中使用屬性運算式。

您可以使用屬性表示式，為套件的每個已部署執行個體自訂組態。 您也可以使用屬性運算式來指定封裝的執行階段條件約束，其方法是搭配 dtexec 命令提示字元公用程式使用 /set 選項。 例如，您可以約束「排序」轉換所使用的 MaximumThreads ，或是「模糊群組」和「模糊查閱」轉換所使用的 MaxMemoryUsage 。 如果未受到約束，這些轉換可能會在記憶體中快取大量的資料。

若要針對本主題所列的其中一個資料流程物件屬性指定屬性運算式，請顯示資料流程工作的 [屬性] 視窗，其方式是在設計工具的 [控制流程] 介面上選取資料流程工作，或是選取設計工具的 [資料流程] 索引標籤，而不需選取任何個別的元件或路徑。 選取 [運算式] 屬性，然後按一下省略符號 (...)，顯示 [屬性運算式編輯器] 對話方塊。 從 屬性 下拉選單中選擇一個屬性，然後在 表達 式文字框中輸入表達式，或點擊省略號（...）以顯示 表達式建構 器對話框。

屬性 清單只會顯示您已放置在設計工具的 資料流程 介面上的資料流程物件之可用屬性。 因此，您無法使用 [屬性] 清單來檢視支援屬性運算式之資料流程物件的所有可能屬性。 例如，如果您已經在設計工具介面上放置 ADO NET 來源，則 [屬性] 清單會包含 [ADO NET Source].[SqlCommand] 屬性的項目。 此清單也會顯示資料流程工作本身的許多屬性。

可以使用屬性運算式來指定下列清單中的屬性值。

資料流程來源

資料流程物件 屬性
ADO NET 來源 TableOrViewName 屬性

SqlCommand 屬性
XML 來源 XMLData 屬性

XMLSchemaDefinition 屬性

資料流程轉換

如需這些自訂屬性的詳細資訊，請參閱 轉換自訂屬性。

資料流程物件 屬性
條件式分割轉換 FriendlyExpression 屬性
衍生的資料行轉換 FriendlyExpression 屬性
模糊群組轉換 MaxMemoryUsage 屬性
模糊查閱轉換 MaxMemoryUsage 屬性
查找轉換 SqlCommand 屬性

SqlCommandParam 屬性
OLE DB 命令轉換 SqlCommand 屬性
百分比取樣轉換 SamplingValue 屬性
樞紐轉換 PivotKeyValue 屬性
資料列取樣轉換 SamplingValue 屬性
排序轉換 MaximumThreads 屬性
取消樞紐轉換 PivotKeyValue 屬性

資料流目的地

資料流程物件 屬性
ADO NET 目的地 TableOrViewName 屬性

BatchSize 屬性

CommandTimeout 屬性
平面檔案目的地 標頭屬性
SQL Server Compact 目的地 TableName 屬性
SQL Server 目的地 BulkInsertTableName 屬性

BulkInsertFirstRow 屬性

BulkInsertLastRow 屬性

BulkInsertOrder 屬性

Timeout 屬性
  • 上次更新時間：