共用方式為


指令碼元件

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

指令碼元件可裝載指令碼,並讓封裝包含及執行自訂指令碼。 您可在封裝中使用指令碼元件以達到下列目的:

  • 套用多個轉換至資料,而不使用資料流程中的多個轉換。 例如,指令碼可以加總兩個資料行中的值,然後計算總和的平均。

  • 存取現有 .NET 組件中的商務規則。 例如,指令碼可以套用商務規則,以指定在 Income 資料行中有效的值範圍。

  • 除了 Integration Services 運算式文法所提供的函數和運算子外,您也可以使用自訂公式和函數。 例如,使用 LUHN 公式驗證信用卡號碼。

  • 驗證資料行資料並略過包含無效資料的記錄。 例如,指令碼可評估合理的郵資金額,並略過金額過高或過低的記錄。

指令碼元件提供簡單快速的方式,用來將自訂函數包含在資料流程中。 不過,如果您計劃在多個封裝中重複使用指令碼,應該考慮以程式設計自訂元件,而不要使用指令碼元件。 如需詳細資訊,請參閱 開發自訂資料流程元件

注意

如果指令碼元件包含指令碼,而該指令碼嘗試讀取 NULL 的資料行值,則當您執行封裝時,此指令碼元件就會失敗。 我們建議您讓您的指令碼使用 IsNull 方法來判斷資料行是否為 NULL,然後再嘗試讀取資料行值。

指令碼元件可當做來源、轉換或目的地使用。 此元件支援一個輸入和多個輸出。 視元件的使用方式而定,可支援輸入、輸出或兩者。 指令碼是由輸入或輸出中的每個資料列所叫用。

  • 如果當做來源使用,指令碼元件可支援多個輸出。

  • 如果當做轉換使用,指令碼元件可支援一個輸入和多個輸出。

  • 如果當做目的地使用,指令碼元件可支援一個輸入。

指令碼元件不支援錯誤輸出。

確定指令碼元件是適用於您封裝的選擇之後,您必須設定輸入和輸出、開發該元件使用的指令碼,以及設定元件本身。

了解指令碼元件模式

在 SSIS Designer 中,指令碼元件有中繼資料設計模式與程式碼設計模式。 在中繼資料設計模式中,您可以加入和修改指令碼元件輸入和輸出,但是不能編寫程式碼。 設定好所有輸入和輸出後,您可以切換到程式碼設計模式編寫指令碼。 指令碼元件會自動從輸入和輸出的中繼資料產生基底程式碼。 如果您在指令碼元件產生基底程式碼後變更中繼資料,您的程式碼可能無法再編譯,因為更新的基底程式碼可能與您的程式碼不相容。

撰寫元件使用的指令碼

指令碼元件使用 Microsoft Visual Studio Tools for Applications (VSTA) 當作撰寫指令碼的環境。 您可以從 [指令碼轉換編輯器] 存取 VSTA。 如需詳細資訊,請參閱指令碼轉換編輯器 ([指令碼] 頁面)

指令碼元件提供 VSTA 專案,其中包含自動產生的類別,該類別名為 ScriptMain 且代表元件中繼資料。 例如,如果指令碼元件當做具有三個輸出的轉換使用,則 ScriptMain 會包含每個輸出的方法。 ScriptMain 是指令碼的進入點。

VSTA 包含 Visual Studio 環境的所有標準功能,例如色彩編碼的 Visual Studio 編輯器、IntelliSense 和物件瀏覽器。 指令碼元件所使用的指令碼會儲存在封裝定義中, 當您要設計封裝時,指令碼會暫時寫入專案檔。

VSTA 支援 Microsoft Visual C# 和 Microsoft Visual Basic 程式設計語言。

如需有關如何以程式設計方式編寫指令碼元件的詳細資訊,請參閱< 以指令碼元件來擴充資料流程>。 如需有關如何將指令碼元件設為來源、轉換或目的地的特定資訊,請參閱< Developing Specific Types of Script Components>。 如需其他範例 (例如示範如何使用指令碼元件的 ODBC 目的地),請參閱< Additional Script Component Examples>。

注意

不像在舊版中可以指出是否已經預先編譯指令碼,所有指令碼在 SQL Server 2008 Integration Services (SSIS) 與更新版本中都會預先編譯。 指令碼經過先行編譯後,在執行階段不會載入語言引擎,因此封裝的執行速度會更快。 不過,先行編譯的二進位檔案會使用大量的磁碟空間。

設定指令碼元件

您可以利用下列方式設定指令碼元件:

  • 選取要參考的輸入資料行。

    注意

    使用 SSIS Designer 時,僅能設定一個輸入。

  • 提供元件執行的指令碼。

  • 指定指令碼語言。

  • 提供唯讀和讀取/寫入變數的逗號分隔清單。

  • 加入更多輸出,並加入指令碼指派的目標輸出資料行。

您可以透過 SSIS 設計師或以程式設計方式設定屬性。

在設計工具中設定指令碼元件

如需如何在 SSIS Designer 中設定這些屬性的詳細資訊,請按一下下列主題:

以程式設計的方式設定指令碼元件

如需有關可以在 [屬性] 視窗中或以程式設計的方式設定之屬性的詳細資訊,請按下列其中一個主題:

如需有關如何設定屬性的詳細資訊,請按下列其中一個主題:

選取指令碼元件類型

使用 [選取指令碼元件類型] 對話方塊,即可指定是否建立指令碼轉換,而這類轉換必須預先設定以作為來源、轉換或目的地。

若要深入了解指令碼元件,請參閱在指令碼元件編輯器中設定指令碼元件。 若要了解如何以程式設計方式編寫指令碼元件,請參閱< 以指令碼元件來擴充資料流程>。

選項。

選擇 [來源][目的地][轉換] ,會影響 [指令碼轉換] 的組態和指令碼轉換編輯器的頁面。

指令碼轉換編輯器 (連接管理員頁面)

使用 [指令碼轉換編輯器] 的 [連線管理員] 頁面,即可指定指令碼將要使用的任何連接。

若要深入了解指令碼元件,請參閱在指令碼元件編輯器中設定指令碼元件。 若要了解如何以程式設計方式編寫指令碼元件,請參閱< 以指令碼元件來擴充資料流程>。

選項。

連接管理員
檢視指令碼使用的可用連接清單。

名稱
輸入連接的唯一和描述性名稱。

連線管理員
從可用的連線管理員清單中選取,或選取 [<新增連線>] 以開啟 [加入 SSIS 連線管理員] 對話方塊。

說明
輸入連接的描述。

加入
將其他連接加入 [連線管理員] 清單中。

移除
從 [連線管理員] 中移除選取的連接。

指令碼轉換編輯器 (輸入資料行頁面)

使用 [指令碼轉換編輯器] 對話方塊的 [輸入資料行] 頁面,對輸入資料行設定屬性。

注意

針對來源元件不會顯示 [輸入資料行] 頁面,因為來源元件只有輸出沒有輸入。

若要深入了解指令碼元件,請參閱在指令碼元件編輯器中設定指令碼元件。 若要了解如何以程式設計方式編寫指令碼元件,請參閱< 以指令碼元件來擴充資料流程>。

選項。

輸入名稱
從可用輸入的清單中選取。

可用的輸入資料行
利用核取方塊來指定指令碼轉換所使用的資料行。

輸入資料行
從每個資料列的可用輸入資料行清單中選取。 您的選擇會反映在 [可用的輸入資料行] 資料表的核取方塊選擇中。

輸出別名
輸入每一個輸出資料行的別名。 預設是輸入資料行的名稱;但是,您可以選擇任何唯一的、描述性名稱。

使用類型
指定指令碼轉換是否要將每個資料行視為 ReadOnly 或是 ReadWrite

指令碼轉換編輯器 (輸入及輸出頁面)

使用 [指令碼轉換編輯器] 對話方塊的 [輸入及輸出] 頁面,即可加入、移除和設定指令碼轉換的輸入及輸出。

注意

來源元件會有輸出但沒有輸入,而目的地元件會有輸入但沒有輸出。 轉換則同時具有輸入和輸出。

若要深入了解指令碼元件,請參閱在指令碼元件編輯器中設定指令碼元件。 若要了解如何以程式設計方式編寫指令碼元件,請參閱< 以指令碼元件來擴充資料流程>。

選項。

Inputs and outputs
在左方選取輸入及輸出,即可在右方檢視其在資料表中的屬性。 可用於編輯的屬性會根據選取範圍而有所不同。 顯示的許多屬性是唯讀的。 如需個別屬性的詳細資訊,請參閱下列主題。

Common Properties

轉換自訂屬性

加入輸出
將其他輸出加入到清單中。

加入資料行
選取要放置新輸出資料行的資料夾,再按一下 [加入資料行] 將其加入。

移除輸出
選取輸出,然後按一下 [移除輸出] 將它移除。

移除資料行
選取資料行,然後按一下 [移除資料行] 將它移除。

指令碼轉換編輯器 (指令碼頁面)

使用 [指令碼轉換編輯器] 對話方塊的 [指令碼] 索引標籤,來指定指令碼和相關的屬性。

若要深入了解指令碼元件,請參閱在指令碼元件編輯器中設定指令碼元件。 若要了解如何以程式設計方式編寫指令碼元件,請參閱< 以指令碼元件來擴充資料流程>。

選項。

屬性
檢視和修改指令碼轉換的屬性。 顯示的許多屬性是唯讀的。 您可以修改下列屬性:

描述
說明 以其用途來描述指令碼轉換。
LocaleID 指定地區設定以提供排序和日期和時間轉換的特定區域資訊。
名稱 輸入元件的描述性名稱。
ValidateExternalMetadata 指出指令碼轉換在設計階段是否對外部資料來源驗證資料行中繼資料。 false 的值將會延遲到執行時間才驗證。
ReadOnlyVariables 輸入以逗號分隔的變數清單,以供指令碼轉換進行唯讀存取。

注意:變數名稱會區分大小寫。
ReadWriteVariables 輸入以逗號分隔的變數清單,以供指令碼轉換進行可讀寫存取。

注意:變數名稱會區分大小寫。
ScriptLanguage 選取指令碼元件所要使用的指令碼語言。

若要為指令碼元件和指令碼工作設定預設指令碼語言,請使用 [選項] 對話方塊上 [一般] 頁面上的 [指令碼語言] 選項。
UserComponentTypeName 指定支援 SQL Server 基礎結構的 ScriptComponentHost 類別和 Microsoft.SqlServer.TxScript 組件。

編輯指令碼
使用 Microsoft Visual Studio Tools for Applications (VSTA) 建立或修改指令碼。

Integration Services 轉換

以指令碼元件來擴充資料流程