建立、部署和偵錯自訂物件

針對 Integration Services 建立、部署和偵錯自訂物件的步驟。

您已經撰寫物件的自訂功能。現在您必須測試它，並使其可供使用者使用。其步驟非常類似於可以為 Integration Services 建立之所有類型的自訂物件。

以下是您在建立、部署及偵錯它時所要遵循的步驟：

1. 簽署要使用強式名稱產生的組件。

2. 建立組件。

3. 將組件移動或是複製到適當的 Integration Services 資料夾，以部署組件。

4. 在全域組件快取 (GAC) 中安裝組件。

5. 當物件是工作或是資料流程元件時，將物件加入至工具箱。

6. 必要時為部署進行疑難排解。

7. 測試和偵錯您的程式碼。

簽署組件

當要共用某個組件時，必須在全域組件快取中安裝它。將組件加入至全域組件快取之後，類似 Business Intelligence Development Studio 的應用程式就可以使用該組件。全域組件快取的要求是組件必須以強式名稱簽署，以確保組件是全域唯一的。強式名稱的組件具有包含組件名稱、文化特性、公開金鑰和版本號碼的完整名稱。執行階段會使用這項資訊找出該組件，並和其他同名的組件區別。

若要使用強式名稱簽署組件，您必須先擁有或是建立公開/私密金鑰組。這個公開和私密密碼編譯金鑰組將在建立時期用來建立強式名稱的組件。

如需有關強式名稱以及簽署組件時必須遵循之步驟的詳細資訊，請參閱在 .NET Framework SDK 文件中的下列主題：

• 強式名稱的組件

• 建立金鑰組

• 使用強式名稱簽署組件

您可以在建立時期使用 Visual Studio 中的強式名稱輕鬆地簽署組件。在 [專案屬性] 對話方塊中，選取 [簽署] 索引標籤。選取 [簽署組件] 的選項，然後提供金鑰 (.snk) 檔案的路徑。

建立組件

在簽署專案之後，您必須在 BI Development Studio 中使用 [建立] 功能表上可用的命令，以建立或是重建專案或方案。您的方案可能包含自訂使用者介面的個別專案，它也必須以強式名稱簽署，而且可以同時建立。

執行後續兩個步驟 (部署組件以及在全域組件快取中安裝它) 的最方便的方法，就是在 Visual Studio 中將這些步驟撰寫成建置後事件。建置事件可從 Visual Basic 專案上 [專案屬性] 頁面的 [編譯] 頁面取得，以及從 C# 專案的 [建置事件] 頁面取得。類似 gacutil.exe 的命令提示字元公用程式需要完整路徑。包含空格的路徑以及展開至包含空格之路徑的巨集 (例如 $(TargetPath)) 都需要用引號括起來。

以下是自訂記錄提供者的建置後事件命令列範例：

"C:\Program Files\Microsoft Visual Studio 9.0\SDK\v3.5\Bin\gacutil.exe" -u $(TargetName)
"C:\Program Files\Microsoft Visual Studio 9.0\SDK\v3.5\Bin\gacutil.exe" -i $(TargetFileName)
copy $(TargetFileName) "C:\Program Files\Microsoft SQL Server\100\DTS\LogProviders "

部署組件

SSIS 設計師會列舉在安裝 SQL Server Integration Services 時所建立之一系列資料夾中所找到的檔案，以尋找封裝中可供使用的自訂物件。在使用預設 SQL Server 安裝設定時，這組資料夾是位於 C:\Program Files\Microsoft SQL Server\100\DTS。不過，如果您為自訂物件建立安裝程式，應該檢查 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath 登錄機碼值以確認此資料夾的位置。

您可以透過下列兩種方法將組件放在資料夾中：

• 在建立編譯的組件之後，將它移動或複製到適當的資料夾 (為了方便起見，您可以在建置後事件中包括複製命令)。

• 直接在適當的資料夾中建置組件。

在 C:\Program Files\Microsoft SQL Server\100\DTS 之下的下列部署資料夾是用於各種類型的自訂物件：

在全域組件快取中安裝組件

若要將工作組件安裝到全域組件快取 (GAC)，請使用命令列工具 gacutil.exe，或是將組件拖曳到 %system%\assembly 目錄。為了方便起見，您也可以在建置後事件中包括 gacutil.exe 的呼叫。

下列命令使用 gacutil.exe 將名為 MyTask.dll 的元件安裝到 GAC。

gacutil /iF MyTask.dll

您必須在安裝新版本的自訂物件之後，關閉和重新開啟 SSIS 設計師。如果您已在全域組件快取中安裝舊版的自訂物件，必須在安裝新版本之前先移除它們。若要解除安裝組件，請執行 gacutil.exe，並使用 /u 選項指定組件名稱。

如需有關全域組件快取的詳細資訊，請參閱 .NET Framework 工具中的全域組件快取工具 (Gactutil.exe)。

將工作或是資料流程元件加入至工具箱

在您已部署自訂物件，並將它安裝在全域組件快取中之後，就可以在 Business Intelligence Development Studio 中使用它，就像 SQL Server Integration Services 隨附的任何物件一樣。然而，它必須明確地加入至 [工具箱]。

將自訂元件加入至工具箱

部署的疑難排解

如果您的自訂物件出現在 [工具箱] 或是可用物件的清單中，但是您無法將它加入至封裝中，請嘗試下列動作：

1. 查詢全域組件快取，以取得元件的多個版本。如果在全域組件快取中有多個版本的元件，設計師可能無法載入您的元件。從全域組件快取中刪除此組件的所有執行個體，然後重新加入該組件。

2. 請確定部署資料夾中只有該組件的單一執行個體存在。

3. 重設工具箱。

4. 將 Visual Studio 附加到 devenv.exe，並設定中斷點以逐步完成初始化程式碼，從而確保沒有例外狀況發生。

測試和偵錯您的程式碼

偵錯自訂物件之執行階段方法最簡單的方法，就是在建立自訂物件和執行使用該元件的封裝之後，從 Visual Studio 啟動 dtexec.exe。

如果您想要偵錯元件的設計階段方法，例如 Validate 方法，請開啟在第二個 Visual Studio 執行個體中使用該元件的封裝，並附加至其 devenv.exe 處理序。

如果您希望當封裝在 SSIS 設計師中開啟和執行時，偵錯元件的執行階段方法，您必須在執行封裝時強制暫停，如此便可附加至 DtsDebugHost.exe 處理序。

附加至 dtexec.exe 來偵錯物件的執行階段方法

將自訂物件的設計階段方法附加到 Business Intelligence Development Studio 以進行偵錯。

將自訂物件的執行階段方法附加到 Business Intelligence Development Studio 來進行偵錯。

請參閱

工作

概念