共用方式為

建立 DataFlow 封裝範例

  • 發行項

更新： 2005 年 12 月 5 日

「建立 DataFlow 封裝」範例示範如何以程式設計方式建立封裝，並加入「資料流程」。此範例中建立的封裝會執行下列動作：

  • 從 AdventureWorks 資料庫的 Products 資料表擷取資料。
  • 建立識別用於排序輸出之資料行的變數。
  • 將結果儲存到一般檔案目的地。
  • 在記憶體中執行封裝。
  • 儲存封裝以供稍後檢閱。
ms161541.note(zh-tw,SQL.90).gif重要事項：
範例只供教育目的之用。它們不能用於實際執行環境，而且從來沒有在實際執行環境中測試過。Microsoft 不提供對這些範例的技術支援。

執行範例

如果您已經知道如何找出、建置和安裝程式碼範例，可以直接跳至＜測試範例＞一節，閱讀有關如何設定與執行程式碼範例的內容。如果您先前沒有用過程式碼範例，則應該先檢視必要條件。

必要條件

執行此程式碼範例之前，請確定已符合下列條件：

  • 開啟 [SQL Server 組態管理員]；按一下 [開始] 功能表，依序指向 [所有程式]、[Microsoft SQL Server 2005] 和 [組態工具]，然後按一下 [SQL Server 組態管理員]。
  • . 展開 [SQL Server 2005 網路組態]。選取 [MSSQLServer 的通訊協定]。以滑鼠右鍵按一下 [TCP/IP]，然後按一下 [啟用]。停止後再重新啟動此服務。如需詳細資訊，請參閱《SQL Server 線上叢書》中的＜如何：使用服務嵌入式管理單元設定 Integration Services 服務的屬性＞。
    或
    開啟 main.cs 檔案，並以您伺服器的名稱取代 adventureWorks.ConnectionString 中指定給 Source 參數的 localhost 值。
  • 程式碼範例及其相關聯的範例資料必須先安裝在本機硬碟上。如需詳細資訊，請參閱《SQL Server 線上叢書》中的＜安裝和編譯 Integration Services 程式設計範例＞。
  • 必須已附加並具有 AdventureWorks 資料庫上的系統管理權限。如需詳細資訊，請參閱《SQL Server 線上叢書》中的＜安裝 AdventureWorks 範例資料庫和範例＞。

若要編譯編碼範例，您將需要 .NET Framework SDK 2.0 或 Microsoft Visual Studio 2005。您可以免費取得 .NET Framework SDK。請參閱《線上叢書》主題＜安裝 .NET Framework SDK＞。

位置

如果程式碼範例安裝於預設位置，則範例位於下列目錄中：

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\CreatePackage Sample

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

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

建立範例

如果您尚未產生強式名稱金鑰檔，請使用下列程序來產生此金鑰檔。

若要產生強式名稱金鑰檔

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

    - 或 -

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

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

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

  3. 在命令提示字元中，執行下列其中一個命令來產生金鑰檔：

    sn -k SampleKey.snk

ms161541.note(zh-tw,SQL.90).gif重要事項：
如需有關強式名稱金鑰組的詳細資訊，請參閱 MSDN 中 .NET Development Center 中的＜Security Briefs: Strong Names and Security in the .NET Framework＞。

若要建立範例

  1. 開啟 [Microsoft Visual Studio 2005]。

  2. 從 [檔案] | [開啟] 功能表，按一下 [專案]，並開啟所要的範例的方案 (.sln)，它可能是來自 CS 資料夾的 CreatePackageCS.sln，或來自 VB 資料夾的 CreatePackageVB.sln，視您想要的語言而定。

  3. 按一下功能表上的 [建立] / [建立 CreateTask]<lang>。

測試範例

當執行程式碼範例時，會在記憶體中執行以程式設計方式建立的封裝，並將其儲存到本機電腦中。

您可以在 SSIS 設計師中開啟封裝，藉此檢視此程式碼範例所建立之已儲存版本的封裝。如需有關如何在 SSIS 設計師中開啟封裝的詳細資訊，請參閱《SQL Server 2005 線上叢書》中的＜如何：將現有的 Integration Services 專案加入方案＞主題。

封裝會儲存到下列位置：

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\CreatePackage Sample\<language>\CreatePackage\bin\Debug\SampleRuntimePackage.dtsx

封裝建立的結果會儲存到下列位置：

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\ \Programming Samples\Control Flow\CreatePackage Sample\<language>\CreatePackage\bin\Debug\SampleRuntimeData.txt

您可以檢查目的地一般檔案中的結果，以驗證封裝是否順利執行。SortColumn 變數所指定的資料行會決定如何排序結果。後續執行範例將會覆寫一般檔案中已儲存的封裝與先前的結果。

執行期間，會將封裝狀態的相關資訊 (包括寫入的資料列數目) 傳送到主控台。下列是輸出到主控台的資訊範例。

OnInformation

SubComponent：DTS.Pipeline

描述：「元件 "FlatFileDestination" (221)」寫入 504 個資料列。

變更歷程記錄

版本 歷程記錄

2006 年 7 月 17 日
變更的內容：
  • 新增了有關如何執行及測試封裝的詳細資訊；描述預期的結果。