Remove Duplicates-Komponentenbeispiel

Das Remove Duplicates-Beispiel veranschaulicht die Implementierung einer Datenfluss-Transformationskomponente mit asynchronen Ausgaben. Komponenten mit asynchronen Ausgaben erhalten PipelineBuffer für die Eingabe und Ausgabe, der der Eingabe und Ausgabe des Objekts entspricht. Der Eingabepuffer enthält von Upstreamkomponenten bereitgestellte Zeilen. Der Ausgabepuffer ist leer. Normalerweise wird er beim Aufruf der Methode ProcessInput von der Komponente mit Zeilen aus dem Eingabepuffer aufgefüllt. Nachdem alle Zeilen empfangen wurden, werden sie sortiert. Anschließend werden die eindeutigen Zeilen an eine Ausgabe und die doppelten Zeilen an eine andere Ausgabe gesendet. Dieses Beispiel wird nicht auf IA64-basierten Systemen unterstützt.

Wichtig:

Die Codebeispiele der Datenflussprogrammierung von Integration Services sind zur Veranschaulichung der Kernfunktionalität gedacht, 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.

Weitere Informationen zum Erstellen einer Komponente mit asynchroner Ausgabe finden Sie im Thema "Developing a Custom Transformation Component with Asynchronous Outputs" in der SQL Server 2005-Onlinedokumentation.

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 die Codebeispiele im standardmäßigen Installationsverzeichnis installiert wurden, befindet sich die C#-Version des Codebeispiels im folgenden Ordner:

C:\Programme\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\RemoveDuplicates 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 nicht bereits eine Schlüsseldatei mit starkem Namen im Ordner Samples generiert haben, gehen Sie wie folgt vor, um diese Schlüsseldatei zu generieren. Die Beispielprojekte sind so konfiguriert, dass Assemblys bei der Erstellung mit dieser Schlüsseldatei signiert werden. Sie können die Signierungseigenschaften auf der Registerkarte Signierung des Dialogfeldes Projekteigenschaften anzeigen.

So generieren Sie eine Schlüsseldatei mit starkem Namen

1. Klicken Sie zum Öffnen einer Microsoft Visual Studio-Eingabeaufforderung auf Start, zeigen Sie auf Alle Programme, anschließend 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, anschließend auf Microsoft .NET Framework SDK 2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.

2. Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Change Directory) vom aktuellen Ordner des Eingabeaufforderungsfensters zum Ordner Samples. Die Schlüsseldatei, die Sie in diesem Ordner erstellen, wird für alle SQL Server 2005-Codebeispiele 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 Standardinstallationsverzeichnis verwendet wurde, sind die Beispieldateien am folgenden Speicherort installiert: <Systemlaufwerk>:\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 auf MSDN.

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 RemoveDuplicates.sln in der gewünschten Programmiersprache.

2. Klicken Sie im Menü Erstellen auf RemoveDuplicates 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 Ihre bevorzugte Anwendung zum Arbeiten im Dateisystem.

2. Kopieren Sie die Assembly (RemoveDuplicatesCS.dll oder RemoveDuplicatesVB.dll) in den Ordner PipelineComponents, der sich unter %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 Ihre bevorzugte Anwendung zum Arbeiten im Dateisystem.

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\RemoveDuplicatesCS.dll "

   - Oder -

   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\RemoveDuplicatesVB.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.

   Hinweis:
   Wenn die Komponente nicht in der Liste angezeigt wird, können Sie auf Durchsuchen klicken, um die Komponente selbst zu suchen. In diesem Fall ist sie jedoch möglicherweise nicht ordnungsgemäß installiert.

Nachdem Sie diese Schritte abgeschlossen 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 und eine Verbindung mit einer anderen Komponente hergestellt haben, die Zeilen bereitstellt, können Sie sie im SSIS-Designer wie folgt konfigurieren:

So konfigurieren Sie die Beispielkomponente in einem Paket

• Wählen Sie die Spalten, die von der Komponente verwendet werden sollen, auf der Registerkarte Eingabespalten im Dialogfeld Erweiterter Editor aus. Nur die ausgewählten Spalten werden an die nächste Komponente im Datenfluss übergeben. Der Inhalt der Spalten wird miteinander verglichen, um so zu ermitteln, ob eine Zeile mit anderen Zeilen übereinstimmt.