移除重複元件範例

發行項
12/15/2008

「移除重複」範例，示範具有非同步輸出的資料流程轉換元件的實作。具有非同步輸出的元件，會接收對應至物件之輸入和輸出的輸入和輸出 PipelineBuffer。輸入緩衝區包含上游元件所提供的資料列。輸出緩衝區為空，通常會在呼叫 ProcessInput 方法期間，由該元件用輸入緩衝區的資料列來填入。接收所有資料列之後，會對它們進行排序，然後會將相異的資料列傳送至一個輸出，而將重複的資料列傳送至另一個輸出。IA64 不支援此範例。

重要事項：
「Integration Services 資料流程程式設計」程式碼範例示範實作所需的核心功能，以建立自訂資料流程元件。範例不包含對於在 [進階編輯器] 中進行自訂的完整支援。例如，您無法使用 [進階編輯器] 加入或移除輸入和輸出，或設定資料行。範例只供教育目的之用。它們不能用於實際執行環境，而且從來沒有在實際執行環境中測試過。Microsoft 不提供對這些範例的技術支援。

「Integration Services 資料流程程式設計」程式碼範例示範實作所需的核心功能，以建立自訂資料流程元件。範例不包含對於在 [進階編輯器] 中進行自訂的完整支援。例如，您無法使用 [進階編輯器] 加入或移除輸入和輸出，或設定資料行。範例只供教育目的之用。它們不能用於實際執行環境，而且從來沒有在實際執行環境中測試過。Microsoft 不提供對這些範例的技術支援。

如需有關建立具有非同步輸出之元件的詳細資訊，請參閱《SQL Server 2005 線上叢書》的＜開發具有非同步輸出的自訂轉換元件＞主題。

執行範例

如果您已經知道如何找出、建置和安裝程式碼範例，可以直接跳至＜測試範例＞一節，閱讀有關如何設定與執行程式碼範例的內容。

必要條件

此範例需要安裝下列元件。

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

位置

如果程式碼範例安裝於預設安裝位置，則 C# 版程式碼範例位於下列資料夾中：

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\RemoveDuplicates Component Sample

程式碼範例的 C# 方案位於 CS 目錄中，而 Visual Basic 方案位於 VB 目錄中。

如需有關安裝範例所需執行之兩個步驟程序的詳細資訊，請參閱＜安裝範例＞。若要取得最新版的範例，包括自 SQL Server 2005 原始發行版本以來所發佈的新範例，請參閱＜SQL Server 2005 範例與範例資料庫 (2006 年 4 月)＞(英文)。

建立範例

如果您尚未在 Samples 資料夾產生強式名稱金鑰檔，請使用下列程序來產生此金鑰檔。範例專案設定為在建置時期使用此金鑰檔簽署組件。您可以在 [專案屬性] 對話方塊的 [簽章] 索引標籤上檢視簽章屬性。

若要產生強式名稱金鑰檔

若要開啟 Microsoft Visual Studio 2005 命令提示字元，請按一下 [開始]，依序指向 [所有程式]、[Microsoft Visual Studio 2005]、[Visual Studio 工具]，然後按一下 [Visual Studio 2005 命令提示字元]。

- 或 -

若要開啟 Microsoft .NET Framework 命令提示字元，請按一下 [開始]，依序指向 [所有程式] 和 [Microsoft .NET Framework SDK 2.0]，然後按一下 [SDK 命令提示字元]。

在命令提示字元中，使用變更目錄 (CD) 命令，將 [命令提示字元] 視窗的目前資料夾變更為 Samples 資料夾。您在此資料夾建立的金鑰檔將供所有 SQL Server 2005 程式碼範例使用。

附註：
若要判斷範例所在的資料夾，按一下 [開始]，依序指向 [所有程式]、[Microsoft SQL Server 2005] 和 [文件集和教學課程]，然後按一下 [範例目錄]。如果是使用預設安裝位置，則範例位於 <system_drive>:\Program Files\Microsoft SQL Server\90\Samples。

在命令提示字元中，執行下列其中一個命令來產生金鑰檔：
```
sn -k SampleKey.snk
```
重要事項：

如需有關強式名稱金鑰組的詳細資訊，請參閱 MSDN 中 .NET Development Center 中的＜Security Briefs: Strong Names and Security in the .NET Framework＞。

重要事項：
如需有關強式名稱金鑰組的詳細資訊，請參閱 MSDN 中 .NET Development Center 中的＜Security Briefs: Strong Names and Security in the .NET Framework＞。

若要在 Microsoft Visual Studio 2005 中建立範例

在 [檔案] | [開啟] 功能表上，按一下 [專案]，並以您偏好的程式設計語言來開啟 RemoveDuplicates.sl。
在 [建立] 功能表上，按一下 [建立 RemoveDuplicates] 來建立專案。

安裝範例

此範例提供有 Visual Basic 和 C# 兩個版本。為了區別各版範例的組件，輸出組件的名稱會附加 CS 或 VB。成功建立元件之後，請遵循這些步驟將它加入 Business Intelligence Development Studio 中的「資料流程」工作。

若要將元件複製到 PipelineComponents 資料夾

開啟 [Windows 檔案總管] 或您偏好的應用程式來使用檔案系統。
將組件 (RemoveDuplicatesCS.dll 或 RemoveDuplicatesVB.dll) 複製到位於 %system%\Program Files\Microsoft SQL Server\90\DTS 的 PipelineComponents 資料夾。

若要透過拖曳組件的方式將元件安裝至全域組件快取 (GAC)

開啟 [Windows 檔案總管] 或您偏好的應用程式來使用檔案系統。
將組件從 PipelineComponents 資料夾拖曳到全域組件快取 (GAC) 所在的資料夾，即 %system%\assembly。

若要使用 gacutil.exe 將元件安裝於全域組件快取 (GAC)

開啟 [命令提示字元] 視窗。
輸入下列命令以執行 gacutil.exe，並將 C# 版元件安裝於 GAC：

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\RemoveDuplicatesCS.dll "

- 或 -

輸入下列命令以執行 gacutil.exe，並將 Visual Basic 版元件安裝至 GAC：

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\RemoveDuplicatesVB.dll "

若要將元件加入工具箱中

開啟 [Business Intelligence Development Studio]。
以滑鼠右鍵按一下工具箱，然後按一下 [選擇項目]。
在 [選擇工具箱項目] 對話方塊中，按一下 [SSIS 資料流程項目] 索引標籤。
按一下元件旁邊的核取方塊，然後按一下 [確定]。

附註：

如果元件未顯示在清單中，您可以按一下 [瀏覽] 來自行尋找元件。不過，在此狀況中，它可能未安裝正確。

附註：
如果元件未顯示在清單中，您可以按一下 [瀏覽] 來自行尋找元件。不過，在此狀況中，它可能未安裝正確。

完成這些步驟之後，元件便會顯示在 [工具箱] 的 [資料來源項目] 索引標籤中，並可將其加入至「SSIS 設計師」中的「資料流程」工作。

測試範例

將元件加入封裝中的「資料流程」工作，並連接到將為其提供資料列的元件之後，您可以在 SSIS 設計師中對其進行下列設定。

若要在封裝中設定範例元件

在 [進階編輯器] 的 [輸入資料行] 索引標籤上選取元件要使用的資料行。只會將選取的資料行傳遞至資料流程中的下一個元件。會比較每個資料行的內容以判斷資料列是否與其他資料列相符。

Share via