Teilen über


SQL Server Integration Services-Pfade

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

Ein Pfad verbindet zwei Komponenten in einem Datenfluss, indem die Ausgabe einer Datenflusskomponente mit der Eingabe einer anderen Komponente verbunden wird. Ein Pfad weist eine Quelle und ein Ziel auf. Wenn z. B. ein Pfad eine Verbindung mit einer OLE DB-Quelle und einer Transformation zum Sortieren herstellt, ist die OLE DB-Quelle die Quelle des Pfads, und die Transformation zum Sortieren ist das Ziel des Pfads. Die Quelle ist die Komponente, wo der Pfad beginnt, und das Ziel ist die Komponente, wo der Pfad endet.

Wenn Sie ein Paket im SSIS-Designer ausführen, können Sie die Daten in einem Datenfluss anzeigen, indem Sie Daten-Viewer an einen Pfad anfügen. Ein Daten-Viewer kann zur Anzeige von Daten in einem Raster konfiguriert werden. Ein Daten-Viewer ist ein hilfreiches Tool zum Debuggen. Weitere Informationen finden Sie unter Debugging Data Flow.

Konfigurieren des Pfads

Der SSIS-Designer stellt das Dialogfeld Datenflusspfad-Editor bereit, in dem Sie Pfadeigenschaften festlegen, die Metadaten der Datenspalten, die über den Pfad übergeben werden, anzeigen sowie Daten-Viewer konfigurieren können.

Zu den konfigurierbaren Pfadeigenschaften gehört der Name, die Beschreibung und die Anmerkung des Pfads. Pfade können auch programmgesteuert konfiguriert werden. Weitere Informationen finden Sie unter Programmgesteuertes Verbinden von Datenflusskomponenten.

Eine Pfadanmerkung zeigt den Namen der Pfadquelle oder den Pfadnamen in der Entwurfsoberfläche der Registerkarte Datenfluss im SSIS-Designer an. Pfadanmerkungen sind mit den Anmerkungen vergleichbar, die Sie Datenflüssen, Ablaufsteuerungen und Ereignishandlern hinzufügen können. Der einzige Unterschied besteht darin, dass eine Pfadanmerkung einem Pfad hinzugefügt wird, während andere Anmerkungen auf den Registerkarten Datenfluss, Ablaufsteuerungund Ereignishandlerdes SSIS-Designers angezeigt werden.

Die Metadaten zeigen den Namen, den Datentyp, die Genauigkeit, die Dezimalstellen, die Länge, die Codepage und die Quellkomponente jeder Spalte in der Ausgabe der vorherigen Komponente an. Die Quellkomponente ist jene Datenflusskomponente, die die Spalte erstellt hat. Dies kann, muss aber nicht die erste Komponente im Datenfluss sein. Beispielsweise werden mit einer Transformation für UNION ALL und einer Transformation zum Sortieren eigene Spalten erstellt, die die Quelle der Ausgabespalten sind. Dagegen können Spalten mit einer Transformation für das Kopieren von Spalten durchlaufen werden, ohne sie zu ändern. Es können auch neue Spalten erstellt werden, indem Eingabespalten kopiert werden. Die Transformation für das Kopieren von Spalten ist nur für neue Spalten die Quellkomponente.

Festlegen der Eigenschaften eines Pfads mit dem Datenflusspfad-Editor

Mit Pfaden werden zwei Datenflusskomponenten verbunden. Wenn Sie Pfadeigenschaften festlegen möchten, muss der Datenfluss mindestens zwei verbundene Datenflusskomponenten enthalten.

  1. Öffnen Sie in SQL Server Data Tools (SSDT) das Integration Services-Projekt mit dem gewünschten Paket.

  2. Doppelklicken Sie im Projektmappen-Explorer auf das Paket, um es zu öffnen.

  3. Klicken Sie auf die Registerkarte Datenfluss , und doppelklicken Sie auf einen Pfad.

  4. Klicken Sie im Dialogfeld Datenflusspfad-Editorauf Allgemein. Nun können Sie den Standardnamen des Pfades bearbeiten und eine Beschreibung des Pfades angeben. Sie können auch die PathAnnotation-Eigenschaft ändern.

  5. Klicken Sie auf OK.

  6. Klicken Sie im Menü Datei auf Ausgewählte Elemente speichern , um das aktualisierte Paket zu speichern.

Seite „Allgemein“ – Datenflusspfad-Editor

Mithilfe des Dialogfelds Datenflusspfad-Editor legen Sie Pfadeigenschaften fest, zeigen Metadaten an und verwalten die mit dem Pfad verknüpften Daten-Viewer.

Mit dem Knoten Allgemein des Dialogfelds Datenflusspfad-Editor werden der Pfad benannt und beschrieben und die Optionen für die Pfadanmerkungen angegeben.

Tastatur

Name
Geben Sie einen eindeutigen Namen für den Pfad an.

ID
Der Herkunftsbezeichner des Pfads. Diese Eigenschaft ist schreibgeschützt.

IdentificationString
Die Zeichenfolge, die den Pfad identifiziert. Wird automatisch aus dem oben eingegebenen Namen erzeugt.

Beschreibung
Beschreiben Sie den Pfad.

PathAnnotation
Geben Sie den Typ der zu verwendenden Anmerkung ein. Wählen Sie Never , um Anmerkungen zu deaktivieren, AsNeeded , um Anmerkungen bei Bedarf zu aktivieren, SourceName , um eine Anmerkung automatisch anhand des Werts der Option SourceName zu erzeugen, oder PathName , um eine Anmerkung automatisch aus dem Wert der Name -Eigenschaft zu erzeugen.

DestinationName
Zeigt die Eingabe an, die das Ende des Pfads angibt.

SourceName
Zeigt die Ausgabe an, die den Beginn des Pfads angibt.

Seite „Metadaten“ – Datenflusspfad-Editor

Verwenden Sie die Seite Metadaten im Dialogfeld Datenflusspfad-Editor , um die Metadaten der Pfadspalten anzuzeigen.

Tastatur

Pfadmetadaten
Listet die Spaltenmetadaten auf. Klicken Sie auf die Spaltenüberschriften, um die Spaltendaten zu sortieren.

Name
Listet den Spaltennamen auf.

Datentyp
Listet den Datentyp der Spalte auf.

Genauigkeit
Listet die Anzahl der Stellen einer numerischen Zahl auf.

Skalierung
Listet die Anzahl der Stellen rechts von der Dezimalstelle einer numerischen Zahl auf.

Länge
Listet die aktuelle Länge der Spalte auf.

Codepage
Listet die Codepage der Spalte auf. Der Wert 0 weist darauf hin, dass die Spalte keine Codepage verwendet. Dies ist der Fall, wenn die Daten als Unicode-, numerischer, Datums- oder Uhrzeitdatentyp vorliegen.

Sortierschlüsselposition
Listet die Sortierschlüsselposition der Spalte auf. Der Wert 0 weist darauf hin, dass die Spalte nicht sortiert ist.

Hinweis

Ein Minus-Präfix (-) weist darauf hin, dass die Spalte in absteigender Reihenfolge sortiert ist.

Vergleichsflags
Listet die Vergleichsflags auf, die auf die Spalte angewendet werden.

Quellkomponente
Listet die Datenflusskomponente auf, die die Quelle der Spalte darstellt.

In Zwischenablage kopieren
Kopiert die Spaltenmetadaten in die Zwischenablage. Standardmäßig werden alle Metadatenzeilen in der aktuell angezeigten Reihenfolge kopiert und sortiert.

Seite „Daten-Viewer“ – Datenflusspfad-Editor

Verwenden Sie die Seite Daten-Viewer des Dialogfelds Datenflusspfad-Editor , um die Daten-Viewer zu verwalten, die dem Pfad zugeordnet sind.

Tastatur

Name
Listet die Daten-Viewer auf.

Typ des Daten-Viewers
Listet den Typ des Daten-Viewers auf.

Add (Hinzufügen)
Klicken Sie auf diese Schaltfläche, um mithilfe des Dialogfelds Daten-Viewer konfigurieren einen Daten-Viewer hinzuzufügen.

Löschen
Klicken Sie auf diese Schaltfläche, um den ausgewählten Daten-Viewer zu löschen.

Konfigurieren
Klicken Sie auf diese Schaltfläche, um mithilfe des Dialogfelds Daten-Viewer konfigurieren einen ausgewählten Daten-Viewer zu konfigurieren.

Path Properties

Die Datenflussobjekte im Microsoft SQL Server Integration Services-Objektmodell verfügen über allgemeine Eigenschaften und benutzerdefinierte Eigenschaften auf der Komponentenebene, der Eingabe- und Ausgabeebene und der Ebene der Eingabe- und Ausgabespalten. Viele Eigenschaften verfügen über schreibgeschützte Werte, für die zur Laufzeit eine Zuweisung über die Datenfluss-Engine erfolgt.

In diesem Thema werden die benutzerdefinierten Eigenschaften der Pfade, die Datenflussobjekte verbinden, aufgelistet und beschrieben.

Benutzerdefinierte Eigenschaften eines Pfads

Im Integration Services-Objektmodell-Objektmodell implementiert ein Pfad, der Komponenten im Datenfluss verbindet, die Schnittstelle IDTSPath100.

Die folgende Tabelle beschreibt die konfigurierbaren Eigenschaften der Pfade in einem Datenfluss. Die Datenfluss-Engine weist auch zusätzlichen schreibgeschützten Eigenschaften, die nicht hier aufgelistet sind, Werte zu.

Eigenschaftenname Datentyp BESCHREIBUNG
PathAnnotation Ganze Zahl (Enumeration) Ein Wert, der angibt, ob eine Anmerkung mit dem Pfad auf der Designeroberfläche angezeigt werden soll. Die möglichen Werte sind AsNeeded, SourceName, PathNameund Never. Der Standardwert ist AsNeeded.
DestinationName IDTSInput100 Die dem Pfad zugeordnete Eingabe.
SourceName IDTSOutput100 Die dem Pfad zugeordnete Ausgabe.