Allgemeine Eigenschaften
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 das Datenflussmodul erfolgt.
In diesem Thema werden die allgemeinen Eigenschaften von Datenflussobjekten aufgelistet und beschrieben.
Komponenten
Eingaben
Eingabespalten
Ausgaben
Ausgabespalten
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 das Datenflussmodul erfolgt.
Eigenschaft |
Datentyp |
Beschreibung |
---|---|---|
ComponentClassID |
Zeichenfolge |
Die CLSID der Komponente. |
ContactInfo |
Zeichenfolge |
Kontaktinformationen für den Entwickler einer Komponente. |
Description |
Zeichenfolge |
Die Beschreibung der Datenflusskomponente. Der Standardwert dieser Eigenschaft entspricht dem Namen der Datenflusskomponente. |
ID |
Ganze Zahl |
Ein Wert, der diese Instanz der Komponente eindeutig identifiziert. |
IdentificationString |
Zeichenfolge |
Identifiziert die Komponente. |
IsDefaultLocale |
Boolesch |
Gibt an, ob die Komponente das Gebietsschema des Datenflusstasks verwendet, zu dem es gehört. |
LocaleID |
Ganze Zahl |
Das Gebietsschema, das die Datenflusskomponente verwendet, wenn das Paket ausgeführt wird. Alle Windows-Gebietsschemas sind zur Verwendung in Datenflusskomponenten verfügbar. |
Name |
Zeichenfolge |
Der Name der Datenflusskomponente. |
PipelineVersion |
Ganze Zahl |
Die Version des Datenflusstasks, innerhalb derer eine Komponente zur Ausführung entworfen wird. |
UsesDispositions |
Boolesch |
Gibt an, ob eine Komponente über eine Fehlerausgabe verfügt. |
ValidateExternalMetadata |
Boolesch |
Gibt an, ob die Metadaten externer Spalten überprüft werden. Der Standardwert dieser Eigenschaft lautet True. |
Version |
Ganze Zahl |
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 das Datenflussmodul erfolgt.
Eigenschaft |
Datentyp |
Beschreibung |
---|---|---|
Description |
Zeichenfolge |
Die Beschreibung der Eingabe. |
ErrorOrTruncationOperation |
Zeichenfolge |
Eine optionale Zeichenfolge, die die Fehlertypen oder abgeschnittene Daten angibt, die bei der Verarbeitung einer Zeile auftreten können. |
ErrorRowDisposition |
Ein Wert, der die Behandlung von Fehlern angibt. Mögliche Werte sind Fail component, Ignore failure und Redirect row. |
|
HasSideEffects |
Boolesch |
Gibt an, ob eine Komponente aus dem Ausführungsplan des Datenflusses entfernt werden kann, wenn diese nicht an eine Downstreamkomponente angefügt ist und RunInOptimizedMode auf true gesetzt ist. |
ID |
Ganze Zahl |
Ein Wert, der die Eingabe eindeutig identifiziert. |
IdentificationString |
Zeichenfolge |
Eine Zeichenfolge, die die Eingabe identifiziert. |
IsSorted |
Boolesch |
Gibt an, ob die Daten in der Eingabe sortiert werden. |
Name |
Zeichenfolge |
Der Name der Eingabe. |
SourceLocale |
Ganze Zahl |
Die Gebietsschema-ID (Locale ID, LCID) der Eingabedaten. |
TruncationRowDisposition |
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 das Datenflussmodul erfolgt.
Eigenschaft |
Datentyp |
Beschreibung |
---|---|---|
ComparisonFlags |
Ganze Zahl |
Eine Gruppe von Flags, die den Vergleich von Spalten angeben, die über einen Zeichendatentyp verfügen. Weitere Informationen finden Sie unter Vergleichen von Zeichenfolgendaten. |
Description |
Zeichenfolge |
Beschreibt die Eingabespalte. |
ErrorOrTruncationOperation |
Zeichenfolge |
Eine optionale Zeichenfolge, die die Fehlertypen oder abgeschnittene Daten angibt, die bei der Verarbeitung einer Zeile auftreten können. |
ErrorRowDisposition |
Ein Wert, der die Behandlung von Fehlern angibt. Mögliche Werte sind Fail component, Ignore failure und Redirect row. |
|
ExternalMetadataColumnID |
Die ID der externen Metadatenspalte, die einer Eingabespalte zugewiesen ist. |
|
ID |
Ganze Zahl |
Ein Wert, der die Eingabespalte eindeutig identifiziert. |
IdentificationString |
Zeichenfolge |
Eine Zeichenfolge, die die Eingabespalte identifiziert. |
LineageID |
Ganze Zahl |
Die ID der Upstreamspalte. |
Name |
Zeichenfolge |
Der Name der Eingabespalte. |
SortKeyPosition |
Ganze Zahl |
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 Vorgehensweise: Sortieren von Daten für die Transformationen für Zusammenführen und Zusammenführungsjoin. |
TruncationRowDisposition |
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 |
Zeichenfolge |
Der Name der Upstreamkomponente. |
UsageType |
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 das Datenflussmodul erfolgt.
Eigenschaft |
Datentyp |
Beschreibung |
---|---|---|
DeleteOutputOnPathDetached |
Boolesch |
Ein Wert, der bestimmt, ob ein Datenflussmodul die Ausgabe löscht, wenn sie von einem Pfad getrennt wird. |
Description |
Zeichenfolge |
Beschreibt die Ausgabe. |
ErrorOrTruncationOperation |
Zeichenfolge |
Eine optionale Zeichenfolge, die die Fehlertypen oder abgeschnittene Daten angibt, die bei der Verarbeitung einer Zeile auftreten können. |
ErrorRowDisposition |
Ein Wert, der die Behandlung von Fehlern angibt. Mögliche Werte sind Fail component, Ignore failure und Redirect row. |
|
ExclusionGroup |
Ganze Zahl |
Ein Wert, der eine Gruppe sich gegenseitig ausschließender Ausgaben identifiziert. |
HasSideEffects |
Boolesch |
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 |
Ganze Zahl |
Ein Wert, der die Ausgabe eindeutig identifiziert. |
IdentificationString |
Zeichenfolge |
Eine Zeichenfolge, die die Ausgabe identifiziert. |
IsErrorOut |
Boolesch |
Gibt an, ob es sich bei der Ausgabe um eine Fehlerausgabe handelt. |
IsSorted |
Boolesch |
Gibt an, ob die Ausgabe sortiert wird. Der Standardwert lautet False.
Wichtig
Durch die Festlegung des Werts für die Eigenschaft IsSorted auf True werden keine Daten sortiert. Diese Eigenschaft ist lediglich ein Hinweis für die Downstreamkomponenten, dass die Daten vorher sortiert wurden. Weitere Informationen finden Sie unter Vorgehensweise: Sortieren von Daten für die Transformationen für Zusammenführen und Zusammenführungsjoin.
|
Name |
Zeichenfolge |
Der Name der Ausgabe. |
SynchronousInputID |
Ganze Zahl |
Die ID einer Eingabe, die zur Ausgabe synchron ist. |
TruncationRowDisposition |
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 das Datenflussmodul erfolgt.
Eigenschaft |
Datentyp |
Beschreibung |
---|---|---|
ComparisonFlags |
Ganze Zahl |
Eine Gruppe von Flags, die den Vergleich von Spalten angeben, die über einen Zeichendatentyp verfügen. Weitere Informationen finden Sie unter Vergleichen von Zeichenfolgendaten. |
Description |
Zeichenfolge |
Beschreibt die Ausgabespalte. |
ErrorOrTruncationOperation |
Zeichenfolge |
Eine optionale Zeichenfolge, die die Fehlertypen oder abgeschnittene Daten angibt, die bei der Verarbeitung einer Zeile auftreten können. |
ErrorRowDisposition |
Ein Wert, der die Behandlung von Fehlern angibt. Mögliche Werte sind Fail component, Ignore failure und Redirect row. Der Standardwert lautet Fehler bei Komponente. |
|
ExternalMetadataColumnID |
Ganze Zahl |
Die ID der externen Metadatenspalte, die einer Eingabespalte zugewiesen ist. |
ID |
Ganze Zahl |
Ein Wert, der die Ausgabespalte eindeutig identifiziert. |
IdentificationString |
Zeichenfolge |
Eine Zeichenfolge, die die Ausgabespalte identifiziert. |
LineageID |
Ganze Zahl |
Die ID der Ausgabespalte. Downstreamkomponenten verweisen auf die Spalte, indem sie diesen Wert verwenden. |
Name |
Zeichenfolge |
Der Name der Ausgabespalte. |
SortKeyPosition |
Ganze Zahl |
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 Vorgehensweise: Sortieren von Daten für die Transformationen für Zusammenführen und Zusammenführungsjoin. |
SpecialFlags |
Ganze Zahl |
Ein Wert, der die speziellen Flags der Ausgabespalte enthält. |
TruncationRowDisposition |
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 lautet Fehler bei Komponente. |
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 das Datenflussmodul erfolgt.
Eigenschaft |
Datentyp |
Beschreibung |
---|---|---|
Description |
Zeichenfolge |
Beschreibt die externe Spalte. |
ID |
Ganze Zahl |
Ein Wert, der die Spalte eindeutig identifiziert. |
IdentificationString |
Zeichenfolge |
Eine Zeichenfolge, die die Spalte identifiziert. |
Name |
Zeichenfolge |
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 |
Ganze Zahl |
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. |
Length |
Ganze Zahl |
Die Länge der Zeichen in einer Spalte. |
Precision |
Ganze Zahl |
Die Genauigkeit einer numerischen Spalte. |
Scale |
Ganze Zahl |
Die Dezimalstellen einer numerischen Spalte. |