Create DataFlow-Paketbeispiel

Aktualisiert: 05. Dezember 2005

Das Create DataFlow-Paketbeispiel zeigt, wie Sie programmgesteuert ein Paket erstellen und einen Datenfluss hinzufügen. Das in diesem Beispiel erstellte Paket führt die folgenden Aktionen aus:

• Extrahiert Daten aus der Products-Tabelle der AdventureWorks-Datenbank.
• Erstellt eine Variable zur Identifizierung der Spalte, die zum Sortieren der Ausgabe verwendet wird.
• Speichert die Ergebnisse in einem Flatfileziel.
• Führt das Paket im Arbeitsspeicher aus.
• Speichert das Paket zur späteren Überprüfung.

Wichtig:
Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für den Einsatz in einer Produktionsumgebung gedacht und wurden auch nicht in einer Produktionsumgebung getestet. Microsoft leistet keinen technischen Support für diese Beispiele.

Ausführen des Beispiels

Wenn Ihnen bereits bekannt ist, wie Codebeispiele gefunden, erstellt und installiert werden, können Sie direkt zum Abschnitt Testen des Beispiels wechseln. Dort erhalten Sie Informationen zum Konfigurieren und Ausführen dieses Codebeispiels. Wenn Sie bisher noch keine Codebeispiele verwendet haben, sollten Sie sich erst mit den Voraussetzungen vertraut machen.

Voraussetzungen

Überprüfen Sie vor dem Ausführen dieses Codebeispiels, ob die folgenden Bedingungen erfüllt sind:

• Öffnen Sie SQL Server-Konfigurations-Manager. Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Microsoft SQL Server 2005, zeigen Sie auf Konfigurationstools, und klicken Sie dann auf SQL Server-Konfigurations-Manager.
• . Erweitern Sie SQL Server 2005-Netzwerkkonfiguration. Wählen Sie die Protokolle für MSSQLServer aus. Klicken Sie mit der rechten Maustaste auf TCP/IP, und klicken Sie dann auf Aktivieren. Beenden und starten Sie den Dienst erneut. Weitere Informationen finden Sie unter "Vorgehensweise: Festlegen von Eigenschaften im Integration Services-Dienst mit dem Dienste-Snap-In" in der SQL Server-Onlinedokumentation.
  Oder
  Öffnen Sie die Datei main.cs, und ersetzen Sie den angegebenen localhost-Wert des Source-Parameters in adventureWorks.ConnectionString mit dem Namen Ihres Servers.
• Das Codebeispiel und die zugehörigen Beispieldaten müssen zunächst auf der lokalen Festplatte installiert werden. Weitere Informationen finden Sie unter "Installieren und Kompilieren von Integration Services-Programmierungsbeispielen" in der SQL Server-Onlinedokumentation.
• Sie müssen die AdventureWorks-Datenbank angefügt haben und über Administratorrechte für die Datenbank verfügen. Weitere Informationen finden Sie unter "Installieren der Beispieldatenbanken und Beispiele für AdventureWorks" in der SQL Server-Onlinedokumentation.

Zum Kompilieren der Codierungsbeispiele benötigen Sie .NET Framework SDK 2.0 oder Microsoft Visual Studio 2005. Das .NET Framework SDK ist kostenlos erhältlich. Weitere Informationen finden Sie im Thema Installieren des .NET Framework SDK in der Onlinedokumentation.

Speicherort

Wenn das Codebeispiel am Standardspeicherort installiert wurde, ist das Beispiel in folgendem Verzeichnis gespeichert:

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

Die C#-Lösung für das Codebeispiel ist im CS-Verzeichnis und die Visual Basic-Lösung im VB-Verzeichnis gespeichert.

Weitere Informationen zu dem zwei Schritte umfassenden Prozess der Installation von Beispielen finden Sie unter Installieren von Beispielen. Wenn Sie die aktuelle Version der Beispiele erhalten möchten, einschließlich neuer Beispiele, die nach der ursprünglichen Version von SQL Server 2005 veröffentlicht wurden, finden Sie entsprechende Informationen unter SQL Server 2005 Samples and Sample Databases (April 2006) (in Englisch).

Erstellen des Beispiels

Wenn Sie noch keine Schlüsseldatei mit starkem Namen generiert haben, generieren Sie diese Schlüsseldatei mithilfe des folgenden Verfahrens.

So generieren Sie eine Schlüsseldatei mit starkem Namen

1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft Visual Studio 2005 und auf Visual Studio Tools, und klicken Sie dann auf Visual Studio 2005-Eingabeaufforderung, um eine Microsoft Visual Studio 2005-Eingabeaufforderung zu öffnen.

   - Oder -

   Klicken Sie auf Start, zeigen Sie auf Alle Programme und auf Microsoft .NET Framework SDK 2.0, und klicken Sie dann auf SDK-Eingabeaufforderung, um eine Microsoft .NET Framework-Eingabeaufforderung zu öffnen.

2. Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Change Directory oder Verzeichnis wechseln) vom aktuellen Ordner im Eingabeaufforderungsfenster zum Ordner Samples. Die von Ihnen in diesem Ordner erstellte Schlüsseldatei wird von allen Microsoft SQL Server 2005-Codebeispielen verwendet.

   Hinweis:
   Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server 2005 und auf Documentation and Tutorials, und klicken Sie dann auf Samples Directory, um den Ordner zu ermitteln, in dem sich die Beispiele befinden. Wenn das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Verzeichnis <system_drive>:\Programme\Microsoft SQL Server\90\Samples.

3. Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Generieren der Schlüsseldatei aus.

   sn -k SampleKey.snk

Wichtig:
Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Starke Namen und Sicherheit im .NET Framework" unter .NET-Entwicklung von MSDN.

So erstellen Sie das Beispiel

1. Öffnen Sie Microsoft Visual Studio 2005.

2. Klicken Sie im Menü Datei auf Öffnen und dann auf Projekt, und öffnen Sie die Projektmappe (SLN) für das gewünschte Beispiel. Je nachdem, welche Sprache Sie verwenden möchten, ist dies die Datei CreatePackageCS.sln im CS-Ordner oder CreatePackageVB.sln in den VB-Ordnern.

3. Klicken Sie im Menü auf Erstellen und dann auf CreateTask<lang> erstellen**.

Testen des Beispiels

Beim Ausführen des Codebeispiels wird das programmgesteuert erstellte Paket im Arbeitsspeicher ausgeführt und auf dem lokalen Computer gespeichert.

Die gespeicherte Version des durch dieses Codebeispiel erstellten Pakets können Sie überprüfen, indem Sie das Paket im SSIS-Designer öffnen. Weitere Informationen zum Öffnen eines Pakets im SSIS-Designer finden Sie im Thema "Vorgehensweise: Hinzufügen eines vorhandenen SQL Server Integration Services-Projekts zu einer Projektmappe" in der SQL Server 2005-Onlinedokumentation.

Das Paket wird am folgenden Speicherort gespeichert:

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

Die vom Paket erstellten Ergebnisse werden am folgenden Speicherort gespeichert:

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

Ob das Paket erfolgreich ausgeführt wurde, können Sie feststellen, indem Sie die Ergebnisse in der Zielflatfile überprüfen. Die in der SortColumn-Variablen angegebene Spalte bestimmt die Sortierreihenfolge der Ergebnisse. Bei einer nachfolgenden Ausführung des Beispiels werden sowohl das gespeicherte Paket als auch die früheren Ergebnisse in der Flatfile überschrieben.

Während der Ausführung werden Informationen zum Paketstatus, einschließlich der Anzahl der geschriebenen Zeilen, an die Konsole ausgegeben. Im Folgenden sehen Sie ein Beispiel zu den an die Konsole ausgegebenen Informationen:

OnInformation

SubComponent: DTS.Pipeline

Beschreibung: "component "FlatFileDestination" (221)" schrieb 504 Zeilen.

Änderungsverlauf

Version	Verlauf
17. Juli 2006	Geänderter Inhalt: Es wurden weitere Einzelheiten zum Ausführen und Testen des Pakets hinzugefügt, und die erwarteten Ergebnisse wurden beschrieben.