DatasetDestination-Komponentenbeispiel

Das DatasetDestination-Beispiel zeigt, wie Sie eine benutzerdefinierte Zielkomponente implementieren, die in Business Intelligence Development Studio integriert ist und einem Datenflusstask hinzugefügt werden kann. Die Komponente speichert die während der Ausführung empfangenen Zeilen in einem Dataset. Am Ende der Ausführung wird das Dataset, je nach Konfiguration der Komponente, einer Laufzeitvariablen zugewiesen und kann auch in einer XML-Datei gespeichert werden. Die aus dem Dataset erstellte XML-Datei kann als XML-Quelle verwendet werden. Dadurch können die Ergebnisse einer Datenflussausführung extern gespeichert und als Quelle für eine andere Komponente verwendet werden. Dieses Beispiel wird nicht auf Itanium-basierten Betriebssystemen unterstützt.

Wichtig:

Die Codebeispiele der Datenflussprogrammierung von Integration Services dienen der Veranschaulichung der Kernfunktionalität, deren Implementierung Voraussetzung für das Erstellen einer benutzerdefinierten Datenflusskomponente ist. Die Beispiele beinhalten keine vollständige Unterstützung für die Anpassung im Erweiterten Editor. So können Sie beispielsweise mit dem Erweiterten Editor keine Eingaben oder Ausgaben hinzufügen bzw. entfernen und auch keine Spalten konfigurieren. 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 des Codebeispiels.

Voraussetzungen

Für dieses Beispiel müssen die folgenden Komponenten installiert sein.

• Microsoft Visual Studio 2005
• Microsoft SQL Server 2005 Integration Services

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\Data Flow\ DataSetDestination Component 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 im Ordner Samples erstellt haben, erstellen Sie diese Datei mithilfe des folgenden Verfahrens. Die Beispielprojekte sind so konfiguriert, dass Assemblys zum Zeitpunkt der Erstellung mit dieser Schlüsseldatei signiert werden. Sie können die Signatureigenschaften auf der Registerkarte Signierung im Dialogfeld Projekteigenschaften anzeigen.

So generieren Sie eine Schlüsseldatei mit starkem Namen

1. Klicken Sie zum Öffnen einer Microsoft Visual Studio 2005-Eingabeaufforderung auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Microsoft Visual Studio 2005 und auf Visual Studio Tools, und klicken Sie dann auf Visual Studio 2005-Eingabeaufforderung.

   - Oder -

   Klicken Sie zum Öffnen einer Microsoft .NET Framework-Eingabeaufforderung auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Microsoft .NET Framework SDK 2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.

2. Verwenden Sie an der Eingabeaufforderung den Befehl zum Ändern des Verzeichnisses (CD), um den aktuellen Ordner des Eingabeaufforderungsfensters in den Ordner Samples zu ändern. Die Schlüsseldatei, die Sie in diesem Ordner erstellen, wird von allen 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 bei der Installation der Standardspeicherort verwendet wurde, befinden sich die Beispiele im Ordner <system_drive>:\Programme\Microsoft SQL Server\90\Samples.

3. Führen Sie an der Eingabeaufforderung den folgenden Befehl aus, um die Schlüsseldatei zu generieren:

   sn -k SampleKey.snk
   

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

So erstellen Sie das Beispiel in Microsoft Visual Studio 2005

1. Klicken Sie im Menü Datei auf Öffnen und auf Projekt, und öffnen Sie dann die Datei DataSetDestination.sln in der von Ihnen bevorzugten Programmiersprache.

2. Klicken Sie im Menü Erstellen auf DatasetDestination erstellen, um das Projekt zu erstellen.

Installieren des Beispiels

Das Beispiel liegt sowohl in einer Visual Basic- als auch in einer C#-Version vor. Um die Assemblys der jeweiligen Version des Beispiels zu unterscheiden, wird CS oder VB an den Namen der Ausgabeassembly angefügt. Führen Sie nach dem erfolgreichen Erstellen der Komponente die folgenden Schritte aus, um die Komponente einem Datenflusstask in Business Intelligence Development Studio hinzuzufügen.

So kopieren Sie die Komponente in den Ordner PipelineComponents

1. Öffnen Sie Windows-Explorer oder die Anwendung, die Sie üblicherweise zum Arbeiten im Dateisystem verwenden.

2. Kopieren Sie die Assembly (DatasetDestinationCS.dll oder DatasetDestinationVB.dll) in den Ordner PipelineComponents, der sich im Verzeichnis %system%\Programme\Microsoft SQL Server\90\DTS befindet.

So installieren Sie die Komponente im globalen Assemblycache (GAC) durch Ziehen der Assembly mit der Maus

1. Öffnen Sie Windows-Explorer oder die Anwendung, die Sie üblicherweise zum Arbeiten im Dateisystem verwenden.

2. Ziehen Sie die Assembly aus dem Ordner PipelineComponents in den Ordner mit dem globalen Assemblycache (GAC) unter %system%\assembly.

So installieren Sie die Komponente im globalen Assemblycache (GAC) mithilfe von gacutil.exe

1. Öffnen Sie ein Eingabeaufforderungsfenster.

2. Geben Sie den folgenden Befehl ein, um gacutil.exe auszuführen und die C#-Version der Komponente im GAC zu installieren:

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

   - or -

   Geben Sie den folgenden Befehl ein, um gacutil.exe auszuführen und die Visual Basic-Version der Komponente im GAC zu installieren:****

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

So fügen Sie die Komponente zur Toolbox hinzu

1. Öffnen Sie Business Intelligence Development Studio.

2. Klicken Sie mit der rechten Maustaste auf die Toolbox, und klicken Sie dann auf Elemente auswählen.

3. Klicken Sie im Dialogfeld Toolboxelemente auswählen auf die Registerkarte SSIS-Datenflusselemente.

4. Klicken Sie auf das Kontrollkästchen neben Ihrer Komponente, und klicken Sie dann auf OK.

5. Hinweis   Wenn die Komponente in der Liste nicht angezeigt wird, können Sie durch Klicken auf Durchsuchen selbst nach der Komponente suchen. In diesem Fall wird die Komponente jedoch möglicherweise nicht ordnungsgemäß installiert.

Nachdem Sie diese Schritte ausgeführt haben, erscheint die Komponente in der Toolbox auf der Registerkarte Datenflusselemente, und sie kann dem Datenflusstask im SSIS-Designer hinzugefügt werden.

Testen des Beispiels

Nachdem Sie die Komponente einem Datenflusstask in einem Paket hinzugefügt haben, können Sie sie im SSIS-Designer konfigurieren. Die DataSetDestination-Komponente verfügt über drei benutzerdefinierte Eigenschaften zur Steuerung ihres Ausführungsverhaltens. Die Komponente wird erfolgreich ausgeführt, wenn Sie für diese Eigenschaften die Standardwerte beibehalten. In diesem Fall wird das Dataset am Ende der Ausführung nicht gespeichert.