Capture Data Lineage-Paketbeispiel

Das Capture Data Lineage-Beispiel ist ein Paket zur Erfassung von Überwachungsinformationen. Beim Ausführen des Pakets werden fünf Dateien mit identischer Konfiguration geladen und mithilfe der Überwachungstransformation Spalten mit Vergangenheitsdaten (z. B. Dateinamen) hinzugefügt. Die Daten werden dann mithilfe eines OLE DB-Ziels in eine Tabelle in der AdventureWorks-Datenbank geladen. Die Tabelle, Lineage_Fact_Table, wird vom Task SQL ausführen erstellt. Der Task schneidet die Tabelle bei jedem Ausführen des Pakets ab.

Wenn Sie das Beispiel unter einer nicht englischsprachigen Version von Windows ausführen, müssen Sie möglicherweise den lokalisierten Namen des Programmdateiordners ersetzen, um das Beispiel öffnen oder ausführen zu können.

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.

Anforderungen

Zum Ausführen dieses Beispielpakets ist Folgendes erforderlich:

• Das Beispielpaket und die von diesem verwendeten Daten müssen auf der lokalen Festplatte installiert sein.
• Sie müssen die AdventureWorks-Datenbank installiert haben und über Administratorrechte für die Datenbank verfügen.
• Wenn Sie beabsichtigen, das Beispielpaket lediglich über die Befehlszeile auszuführen, müssen Sie SQL Server 2005 Integration Services (SSIS) installieren.
• Wenn Sie beabsichtigen, das Paket im SSIS-Designer zu öffnen und das Beispielpaket auszuführen, müssen Sie Business Intelligence Development Studio installieren.

Weitere Informationen zum Installieren von Beispielen finden Sie unter "Installieren von Integration Services-Beispielpaketen" in der SQL Server 2005-Onlinedokumentation. 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).

Speicherort des Beispielpakets

Wenn die Beispiele im Standardverzeichnis installiert wurden, befindet sich das Capture Data Lineage-Beispielpaket, CaptureDataLineage.dtsx, im folgenden Ordner:

C:\Programme\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CaptureDataLineage Sample\Capture Data Lineage\

Zum Ausführen des Beispielpakets sind die folgenden Dateien erforderlich.

Datei	Beschreibung
CaptureDataLineage.dtsx	Das Beispielpaket
Data732.txt	Eine Flatfile mit Beispieldaten
Data733.txt	Eine Flatfile mit Beispieldaten
Data734.txt	Eine Flatfile mit Beispieldaten
Data735.txt	Eine Flatfile mit Beispieldaten
Data736.txt	Eine Flatfile mit Beispieldaten

Ausführen des Beispiels

Das Paket kann von der Befehlszeile aus mithilfe des Dienstprogramms dtexec oder in Business Intelligence Development Studio ausgeführt werden.

Wenn Sie eine nicht englischsprachige Version von Windows verwenden, müssen Sie möglicherweise die ConnectionString-Eigenschaft aller Dateiverbindungs-Manager aktualisieren, der in dem Paket verwendet wurde, um das Beispielpaket erfolgreich auszuführen. Überprüfen Sie, ob der im Verbindungs-Manager verwendete Pfad auf Ihrem Computer gültig ist, und ändern Sie ihn ggf. so, dass er den lokalisierten Namen des Programmdateiordners verwendet.

Für dieses Beispiel müssen Sie möglicherweise "Programme" in der ConnectionString-Eigenschaft für den Verbindungs-Manager Sample Data aktualisieren.

So führen Sie das Paket mithilfe von dtexec aus

1. Öffnen Sie ein Eingabeaufforderungsfenster.

2. Wechseln Sie in das Verzeichnis C:\Programme\Microsoft SQL Server\90\DTS\Binn, in dem sich dtexec befindet.

3. Geben Sie folgenden Befehl ein:

   dtexec /f "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CaptureDataLineage Sample\CaptureDataLineage\CaptureDataLineage.dtsx"
   

4. Drücken Sie die Eingabetaste.

Weitere Informationen zum Ausführen des Pakets mithilfe des Dienstprogramms dtexec finden Sie im Thema "dtexec (Dienstprogramm)" in der SQL Server 2005-Onlinedokumentation.

So führen Sie das Paket in Business Intelligence Development Studio aus

1. Öffnen Sie Business Intelligence Development Studio.

2. Zeigen Sie im Menü Datei auf Öffnen, und klicken Sie auf Projekt/Projektmappe.

3. Suchen Sie den Ordner CaptureDataLineage Sample, und doppelklicken Sie auf die Datei namens CaptureDataLineage.sln.

4. Klicken Sie mit der rechten Maustaste im Projektmappen-Explorer im Ordner SSIS-Pakete auf CaptureDataLineage.dtsx, und klicken Sie dann auf Paket ausführen.

Komponenten im Beispiel

Die folgende Tabelle führt die im Beispiel verwendeten Integration Services-Tasks, -Container, -Datenadapter und -Transformationen auf.

Element

Zweck

Task SQL ausführen

Der Task SQL ausführen, Create Lineage_Fact_Table, führt eine SQL-Anweisung aus, die beim erstmaligen Ausführen des Pakets die Lineage_Fact_Table-Tabelle erstellt und dann bei erneutem Ausführen des Pakets die Tabelle abschneidet.

Datenflusstask

Der Datenflusstask, Get Data Lineage Information, führt den Datenfluss im Paket aus.

Flatfilequelle

Die Flatfilequelle Extract Data from Files lädt die Flatfile-Quellendaten und fügt jeder Ausgabezeile eine Spalte für den Dateinamen hinzu.

Überwachungstransformation

Die Überwachungstransformation, Add Data Lineage Information, fügt jeder Ausgabezeile zwei neue Spalten für Herkunftsinformationen hinzu. Die Spalten enthalten den Benutzernamen und die Startzeit.

Hinweis:

Die Standardlänge der Spalte für den Benutzernamen beträgt 64 Zeichen. Sollten in Ihrer Organisation Benutzernamen mit mehr als 64 Zeichen vorkommen, müssen Sie die Spaltenlänge mithilfe des Dialogfeldes Erweiterter Editor entsprechend aktualisieren.

OLE DB-Ziel

Das OLE DB-Ziel, Load Data into Lineage_Fact_Table, lädt die Ergebnisse in die Lineage_Fact_Table-Tabelle der AdventureWorks-Datenbank.

Verbindungs-Manager für mehrere Flatfiles

Der Verbindungs-Manager für mehrere Flatfiles, Sample Data, stellt Verbindungen zu den Dateien mit der Erweiterung .txt her.

OLE DB-Verbindungs-Manager

Der OLE DB-Verbindungs-Manager, (local).AdventureWorks, stellt eine Verbindung zur AdventureWorks-Datenbank auf dem lokalen Server her.

Beispielergebnisse

Um die Ausführungsergebnisse des Capture Data Lineage-Beispielpakets anzuzeigen, müssen Sie folgende Transact-SQL-Abfrage ausführen:

Select * from AdventureWorks.dbo.Lineage_Fact_Table

In diesen Ergebnissen sehen Sie, dass die Spalten mit den aus den Flatfiles abgerufenen Daten aufgefüllt wurden. Zusätzlich sind in den Spalten File Name, User Name und Execution Start Time generierte Herkunftsinformationen enthalten.