Readme_ADO Source-Komponentenbeispiel

Artikel
09/18/2009

Dieses Beispiel funktioniert nur mit SQL Server 2005 und SQL Server 2008. In einer SQL Server-Version vor SQL Server 2005 kann das Beispiel nicht ausgeführt werden.

Das ADO Source-Komponentenbeispiel zeigt, wie Sie eine Quellkomponente implementieren, die sich als Datenquelle im Datenflusstask verwenden lässt. Diese Komponente stellt mithilfe des ADO.NET-Verbindungs-Managers eine Verbindung zu einer Datenbank her und führt die vom Benutzer bereitgestellte SQL-Anweisung aus. Die durch die Ausführung der Anweisung abgerufenen Zeilen werden PipelineBuffer hinzugefügt, der der Komponente vom Datenflusstask bereitgestellt wird, und anschließend für die Downstreamkomponenten verfügbar gemacht.

Hinweis

Weitere Informationen zu Quellkomponenten finden Sie unter "Erstellen einer Quellkomponente" in der SQL Server-Onlinedokumentation.

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 enthalten 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
Microsoft SQL Server 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\Ado Source 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 Überlegungen zum Installieren der SQL Server-Beispiele und -Beispieldatenbanken.

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

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

- Oder -

Klicken Sie zum Öffnen einer Microsoft .NET Framework-Eingabeaufforderung auf Start, zeigen Sie auf Alle Programme und auf Microsoft .NET Framework SDK 2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.
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 von Ihnen in diesem Ordner erstellte Schlüsseldatei wird von allen SQL Server-Codebeispielen verwendet.

Hinweis

Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server 2008 und auf Dokumentation und Lernprogramme, und klicken Sie dann auf Beispielordner, um den Ordner zu ermitteln, in dem sich die Beispiele befinden. Wenn das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Verzeichnis <Laufwerk>:\Programme\Microsoft SQL Server\100\Samples.
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 in Microsoft Visual Studio 2008

Klicken Sie im Menü Datei auf Öffnen und auf Projekt, und öffnen Sie dann die Datei AdoSource.sln in der gewünschten Programmiersprache.
Klicken Sie im Menü Erstellen auf AdoSource 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 nachfolgenden Schritte aus, um die Komponente in Business Intelligence Development Studio zu verwenden.

So kopieren Sie die Komponente in den Ordner PipelineComponents

Öffnen Sie Windows-Explorer oder Ihre bevorzugte Anwendung zum Arbeiten im Dateisystem.
Kopieren Sie die Assembly (AdoSourceCS.dll oder AdoSourceVB.dll) in den Ordner PipelineComponents, der sich unter %system%\Programme\Microsoft SQL Server\100\DTS befindet.

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

Öffnen Sie Windows-Explorer oder Ihre bevorzugte Anwendung zum Arbeiten im Dateisystem.
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

Öffnen Sie ein Eingabeaufforderungsfenster.
Geben Sie den folgenden Befehl ein, um gacutil.exe auszuführen und die C#-Version der Komponente im globalen Assemblycache zu installieren:

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\100\DTS\PipelineComponents\AdoSourceCS.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\100\DTS\PipelineComponents\AdoSourceVB.dll"

So fügen Sie die Komponente zur Toolbox hinzu

Öffnen Sie Business Intelligence Development Studio.
Klicken Sie mit der rechten Maustaste auf die Toolbox, und klicken Sie dann auf Elemente auswählen.
Klicken Sie im Dialogfeld Toolboxelemente auswählen auf die Registerkarte SSIS-Datenflusselemente.
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 ausgeführt haben, erscheint die Komponente im Abschnitt Datenflussquellen der Toolbox und kann der Datenflussaufgabe im Designer hinzugefügt werden.

Testen des Beispiels

Nachdem Sie die Komponente einem Datenflusstask in einem Paket hinzugefügt haben, können Sie sie wie folgt im SSIS-Designer konfigurieren.

So konfigurieren Sie die Beispielkomponente in einem Paket

Fügen Sie dem Paket einen ADO.NET-Verbindungs-Manager hinzu, und wählen Sie den Microsoft OLE DB-Anbieter für SQL Server aus. Konfigurieren Sie die Beispielkomponente so, dass sie diesen Verbindungs-Manager verwendet.
Konfigurieren Sie unter Benutzerdefinierte Eigenschaften auf der Seite Komponenteneigenschaften im erweiterten Editor die benutzerdefinierte Eigenschaft SqlStatement der Komponente. Geben Sie hierzu eine gültige SQL-Abfrage an Tabellen oder Sichten in der Datenbank ein, zu der der Verbindungs-Manager eine Verbindung herstellt.

Share via