Allgemeine Eigenschaften

  • Artikel

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 allgemeinen Eigenschaften von Datenflussobjekten aufgelistet und beschrieben.

Informationen zu benutzerdefinierten Eigenschaften finden Sie unter folgenden Themen

Komponenteneigenschaften

Im Integration Services-Objektmodell implementiert eine Komponente im Datenfluss die Schnittstelle IDTSComponentMetaData100.

Die folgende Tabelle beschreibt die Eigenschaften der Komponenten in einem Datenfluss. Einige Eigenschaften verfügen über schreibgeschützte Werte, für die zur Laufzeit eine Zuweisung über die Datenfluss-Engine erfolgt.

Eigenschaft Datentyp BESCHREIBUNG
ComponentClassID String Die CLSID der Komponente.
ContactInfo String Kontaktinformationen für den Entwickler einer Komponente.
BESCHREIBUNG String Die Beschreibung der Datenflusskomponente. Der Standardwert dieser Eigenschaft entspricht dem Namen der Datenflusskomponente.
id Integer Ein Wert, der diese Instanz der Komponente eindeutig identifiziert.
IdentificationString String Identifiziert die Komponente.
IsDefaultLocale Boolean Gibt an, ob die Komponente das Gebietsschema des Datenflusstasks verwendet, zu dem es gehört.
LocaleID Integer Das Gebietsschema, das die Datenflusskomponente verwendet, wenn das Paket ausgeführt wird. Alle Windows-Gebietsschemas sind zur Verwendung in Datenflusskomponenten verfügbar.
Name String Der Name der Datenflusskomponente.
PipelineVersion Integer Die Version des Datenflusstasks, innerhalb derer eine Komponente zur Ausführung entworfen wird.
UsesDispositions Boolean Gibt an, ob eine Komponente über eine Fehlerausgabe verfügt.
ValidateExternalMetadata Boolean Gibt an, ob die Metadaten externer Spalten überprüft werden. Der Standardwert dieser Eigenschaft ist True.
Version Integer Die Version einer Komponente.

Eingabeeigenschaften

Im Integration Services -Objektmodell verfügen Transformationen und Ziele über Eingaben. Eine Eingabe einer Komponente im Datenfluss implementiert die Schnittstelle IDTSInput100.

Die folgende Tabelle beschreibt die Eigenschaften der Eingaben von Komponenten in einem Datenfluss. Einige Eigenschaften verfügen über schreibgeschützte Werte, für die zur Laufzeit eine Zuweisung über die Datenfluss-Engine erfolgt.

Eigenschaft Datentyp BESCHREIBUNG
BESCHREIBUNG String Die Beschreibung der Eingabe.
ErrorOrTruncationOperation String Eine optionale Zeichenfolge, die die Fehlertypen oder abgeschnittene Daten angibt, die bei der Verarbeitung einer Zeile auftreten können.
ErrorRowDisposition DTSRowDisposition Ein Wert, der die Behandlung von Fehlern angibt. Mögliche Werte sind Fail component, Ignore failure und Redirect row.
HasSideEffects Boolean Gibt an, ob eine Komponente aus dem Ausführungsplan des Datenflusses entfernt werden kann, wenn sie nicht an eine nachgeschaltete Komponente angefügt ist und wann RunInOptimizedMode ist true.
id Integer Ein Wert, der die Eingabe eindeutig identifiziert.
IdentificationString String Eine Zeichenfolge, die die Eingabe identifiziert.
IsSorted Boolean Gibt an, ob die Daten in der Eingabe sortiert werden.
Name String Der Name der Eingabe.
SourceLocale Integer Die Gebietsschema-ID (Locale ID, LCID) der Eingabedaten.
TruncationRowDisposition DTSRowDisposition Ein Wert, der bestimmt, wie die Komponente das Abschneiden von Daten behandelt, das bei der Verarbeitung von Zeilen auftritt. . Mögliche Werte sind Fail component, Ignore failure und Redirect row.

Ziele und einige Transformationen unterstützen keine Fehlerausgaben, und die Eigenschaften ErrorRowDisposition und TruncationRowDisposition dieser Komponenten sind schreibgeschützt.

Eigenschaften der Eingabespalten

Im Integration Services -Objektmodell enthält eine Eingabe eine Auflistung von Eingabespalten. Eine Eingabespalte einer Komponente im Datenfluss implementiert die Schnittstelle IDTSInputColumn100.

Die folgende Tabelle beschreibt die Eigenschaften der Eingabespalten von Komponenten in einem Datenfluss. Einige Eigenschaften verfügen über schreibgeschützte Werte, für die zur Laufzeit eine Zuweisung über die Datenfluss-Engine erfolgt.

Eigenschaft Datentyp BESCHREIBUNG
ComparisonFlags Integer Eine Gruppe von Flags, die den Vergleich von Spalten angeben, die über einen Zeichendatentyp verfügen. Weitere Informationen finden Sie unter Comparing String Data.
BESCHREIBUNG String Beschreibt die Eingabespalte.
ErrorOrTruncationOperation String Eine optionale Zeichenfolge, die die Fehlertypen oder abgeschnittene Daten angibt, die bei der Verarbeitung einer Zeile auftreten können.
ErrorRowDisposition DTSRowDisposition Ein Wert, der die Behandlung von Fehlern angibt. Mögliche Werte sind Fail component, Ignore failure und Redirect row.
ExternalMetadataColumnID IDTSExternalMetadataColumn100 Die ID der externen Metadatenspalte, die einer Eingabespalte zugewiesen ist.
id Integer Ein Wert, der die Eingabespalte eindeutig identifiziert.
IdentificationString String Eine Zeichenfolge, die die Eingabespalte identifiziert.
LineageID Integer Die ID der Upstreamspalte.
Name String Der Name der Eingabespalte.
SortKeyPosition Integer Ein Wert, der anzeigt, ob eine Spalte sortiert ist, und der die zugehörige Sortierreihenfolge und die Reihenfolge, in der mehrere Spalten sortiert werden, angibt. Der Wert 0 weist darauf hin, dass die Spalte nicht sortiert ist. Weitere Informationen finden Sie unter Sortieren von Daten für die Transformationen für Zusammenführen und Zusammenführungsjoin.
TruncationRowDisposition DTSRowDisposition Ein Wert, der bestimmt, wie die Komponente das Abschneiden von Daten behandelt, das bei der Verarbeitung von Zeilen auftritt. Mögliche Werte sind Fail component, Ignore failure und Redirect row.
UpstreamComponentName String Der Name der Upstreamkomponente.
UsageType DTSUsageType Ein Wert, der bestimmt, wie eine Eingabespalte von der Komponente verwendet wird.

Eingabespalten verfügen auch über die Datentypeigenschaften, die unter "Datentypeigenschaften" beschrieben sind.

Ausgabeeigenschaften

Im Integration Services -Objektmodell verfügen Quellen und Transformationen über Ausgaben. Eine Ausgabe einer Komponente im Datenfluss implementiert die Schnittstelle IDTSOutput100.

Die folgende Tabelle beschreibt die Eigenschaften der Ausgaben von Komponenten in einem Datenfluss. Einige Eigenschaften verfügen über schreibgeschützte Werte, für die zur Laufzeit eine Zuweisung über die Datenfluss-Engine erfolgt.

Eigenschaft Datentyp BESCHREIBUNG
DeleteOutputOnPathDetached Boolean Ein Wert, der bestimmt, ob eine Datenfluss-Engine die Ausgabe löscht, wenn sie von einem Pfad getrennt wird.
BESCHREIBUNG String Beschreibt die Ausgabe.
ErrorOrTruncationOperation String Eine optionale Zeichenfolge, die die Fehlertypen oder abgeschnittene Daten angibt, die bei der Verarbeitung einer Zeile auftreten können.
ErrorRowDisposition DTSRowDisposition Ein Wert, der die Behandlung von Fehlern angibt. Mögliche Werte sind Fail component, Ignore failure und Redirect row.
ExclusionGroup Integer Ein Wert, der eine Gruppe sich gegenseitig ausschließender Ausgaben identifiziert.
HasSideEffects Boolean Ein Wert, der angibt, ob eine Komponente aus dem Ausführungsplan des Datenflusses entfernt werden kann, wenn diese nicht an eine Upstreamkomponente angefügt ist und RunInOptimizedMode auf true gesetzt ist.
id Integer Ein Wert, der die Ausgabe eindeutig identifiziert.
IdentificationString String Eine Zeichenfolge, die die Ausgabe identifiziert.
IsErrorOut Boolean Gibt an, ob es sich bei der Ausgabe um eine Fehlerausgabe handelt.
IsSorted Boolean Gibt an, ob die Ausgabe sortiert wird. Der Standardwert ist False.

**Wichtig** Wenn Sie den Wert der IsSorted Eigenschaft auf festlegen, True werden die Daten nicht sortiert. Diese Eigenschaft ist lediglich ein Hinweis für die Downstreamkomponenten, dass die Daten vorher sortiert wurden. Weitere Informationen finden Sie unter Sortieren von Daten für die Transformationen für Zusammenführen und Zusammenführungsjoin.
Name String Der Name der Ausgabe.
SynchronousInputID Integer Die ID einer Eingabe, die zur Ausgabe synchron ist.
TruncationRowDisposition DTSRowDisposition Ein Wert, der bestimmt, wie die Komponente das Abschneiden von Daten behandelt, das bei der Verarbeitung von Zeilen auftritt. Mögliche Werte sind Fail component, Ignore failure und Redirect row.

Eigenschaften der Ausgabespalten

Im Integration Services -Objektmodell enthält eine Ausgabe eine Auflistung von Ausgabespalten. Eine Ausgabespalte einer Komponente im Datenfluss implementiert die Schnittstelle IDTSOutputColumn100.

Die folgende Tabelle beschreibt die Eigenschaften der Ausgabespalten von Komponenten in einem Datenfluss. Einige Eigenschaften verfügen über schreibgeschützte Werte, für die zur Laufzeit eine Zuweisung über die Datenfluss-Engine erfolgt.

Eigenschaft Datentyp BESCHREIBUNG
ComparisonFlags Integer Eine Gruppe von Flags, die den Vergleich von Spalten angeben, die über einen Zeichendatentyp verfügen. Weitere Informationen finden Sie unter Comparing String Data.
BESCHREIBUNG String Beschreibt die Ausgabespalte.
ErrorOrTruncationOperation String Eine optionale Zeichenfolge, die die Fehlertypen oder abgeschnittene Daten angibt, die bei der Verarbeitung einer Zeile auftreten können.
ErrorRowDisposition DTSRowDisposition Ein Wert, der die Behandlung von Fehlern angibt. Mögliche Werte sind Fail component, Ignore failure und Redirect row. Der Standardwert ist Fail component.
ExternalMetadataColumnID Integer Die ID der externen Metadatenspalte, die einer Eingabespalte zugewiesen ist.
id Integer Ein Wert, der die Ausgabespalte eindeutig identifiziert.
IdentificationString String Eine Zeichenfolge, die die Ausgabespalte identifiziert.
LineageID Integer Die ID der Ausgabespalte. Downstreamkomponenten verweisen auf die Spalte, indem sie diesen Wert verwenden.
Name String Der Name der Ausgabespalte.
SortKeyPosition Integer Ein Wert, der anzeigt, ob eine Spalte sortiert ist, und der die zugehörige Sortierreihenfolge und die Reihenfolge, in der mehrere Spalten sortiert werden, angibt. Der Wert 0 weist darauf hin, dass die Spalte nicht sortiert ist. Weitere Informationen finden Sie unter Sortieren von Daten für die Transformationen für Zusammenführen und Zusammenführungsjoin.
SpecialFlags Integer Ein Wert, der die speziellen Flags der Ausgabespalte enthält.
TruncationRowDisposition DTSRowDisposition Ein Wert, der bestimmt, wie die Komponente das Abschneiden von Daten behandelt, das bei der Verarbeitung von Zeilen auftritt. Mögliche Werte sind Fail component, Ignore failure und Redirect row. Der Standardwert ist Fail component.

Ausgabespalten schließen auch eine Gruppe von Datentypeigenschaften ein.

Eigenschaften externer Metadatenspalten

Im Integration Services -Objektmodell können Eingaben und Ausgaben eine Auflistung externer Metadatenspalten enthalten. Eine externe Metadatenspalte einer Komponente im Datenfluss implementiert die Schnittstelle IDTSExternalMetadataColumn100.

Die folgende Tabelle beschreibt die Eigenschaften der externen Metadatenspalten von Komponenten in einem Datenfluss. Einige Eigenschaften verfügen über schreibgeschützte Werte, für die zur Laufzeit eine Zuweisung über die Datenfluss-Engine erfolgt.

Eigenschaft Datentyp BESCHREIBUNG
BESCHREIBUNG String Beschreibt die externe Spalte.
id Integer Ein Wert, der die Spalte eindeutig identifiziert.
IdentificationString String Eine Zeichenfolge, die die Spalte identifiziert.
Name String Der Name der externen Spalte.

Externe Metadatenspalten schließen auch eine Gruppe von Datentypeigenschaften ein.

Datentypeigenschaften

Ausgabespalten und externe Metadatenspalten schließen eine Gruppe von Datentypeigenschaften ein. Je nach dem Datentyp der Spalte können Eigenschaften einen Lese-/Schreibzugriff oder einen Schreibschutz festlegen.

Die folgende Tabelle beschreibt die Datentypeigenschaften von Ausgabespalten und externen Metadatenspalten.

Eigenschaft Datentyp BESCHREIBUNG
CodePage Integer Gibt die Codepage für Zeichenfolgendaten an, bei denen es sich nicht um Unicode handelt.
DataType Ganze Zahl (Enumeration) Der Integration Services -Datentyp der Spalte. Weitere Informationen finden Sie unter Integration Services Datentypen.
Länge Integer Die Länge der Zeichen in einer Spalte.
Genauigkeit Integer Die Genauigkeit einer numerischen Spalte.
Skalieren Integer Die Dezimalstellen einer numerischen Spalte.

Weitere Informationen

Datenfluss
Benutzerdefinierte Eigenschaften von Transformationen
Pfadeigenschaften
Data Flow-Eigenschaften, die mithilfe von Ausdrücken festgelegt werden können