Benutzerdefinierte Eigenschaften von Quellen

Die Datenflussobjekte in den MicrosoftSQL ServerIntegration Services-Objektmodellen verfügen über allgemeine Eigenschaften und benutzerdefinierte Eigenschaften auf der Komponentenebene, der Eingabe- und Ausgabeebene und der Ebene der Eingabe- und Ausgabespalten. Der Zugriff auf die benutzerdefinierten Eigenschaften ist nur zur Laufzeit möglich, und die benutzerdefinierten Eigenschaften sind nicht in der Integration Services Managed Programming Referenz-Dokumentation dokumentiert.

In diesem Thema werden die benutzerdefinierten Eigenschaften von Datenflussquellen aufgelistet und beschrieben.

  • ADO NET-Quelle

  • Excel-Quelle

  • Flatfilequelle

  • OLE DB-Quelle

  • Rohdatendatei-Quelle

  • XML-Quelle

Informationen über die gemeinsamen Eigenschaften der meisten Datenflussobjekte finden Sie unter Allgemeine Eigenschaften.

Einige Eigenschaften von Quellen können mit Eigenschaftsausdrücken festgelegt werden, wie in diesem Thema angegeben. Weitere Informationen finden Sie unter Data Flow-Eigenschaften können mithilfe von Ausdrücken festgelegt werden..

Benutzerdefinierte Eigenschaften der ADO NET-Quelle

Die ADO NET-Quelle verfügt sowohl über benutzerdefinierte Eigenschaften als auch über die Eigenschaften, die allen Datenflusskomponenten gemeinsam sind.

In der folgenden Tabelle werden die benutzerdefinierten Eigenschaften der ADO NET-Quelle beschrieben. Alle Eigenschaften weisen Lese-/Schreibzugriff auf.

Eigenschaftsname

Datentyp

Beschreibung

CommandTimeout

Zeichenfolge

Ein Wert, der die Anzahl der Sekunden angibt, bevor für den SQL-Befehl ein Timeout eintritt. Der Wert 0 gibt an, dass bei dem Befehl nie ein Timeout eintritt.

SqlCommand

Zeichenfolge

Die SQL-Anweisung, die die ADO NET-Quelle zum Extrahieren von Daten verwendet.

Während das Paket geladen wird, können Sie diese Eigenschaft dynamisch mit der SQL-Anweisung aktualisieren, die die ADO NET-Quelle verwendet. Weitere Informationen finden Sie unter Referenzinformationen zu SQL Server Integration Services-Ausdrücken und unter Verwendung von Eigenschaftsausdrücken in Paketen.

AllowImplicitStringConversion

Boolesch

Ein Wert, der angibt, ob Folgendes eintritt:

  • Es wird kein Validierungsfehler generiert, wenn eine Unstimmigkeit zwischen externen Metadatentypen und Ausgabespaltentypen in Form von Zeichenfolgen auftritt (DT_WSTR oder DT_NTEXT).

  • Implizite Konvertierung externer Metadatentypen in den string-Datentyp, den die Ausgabespalte verwendet.

Der Standardwert ist TRUE.

Weitere Informationen finden Sie unter ADO NET-Quelle.

Die Ausgabe und die Ausgabespalten der ADO NET-Quelle verfügen nicht über benutzerdefinierte Eigenschaften.

Weitere Informationen finden Sie unter ADO NET-Quelle.

Benutzerdefinierte Eigenschaften der Excel-Quelle

Die Excel-Quelle verfügt sowohl über benutzerdefinierte Eigenschaften als auch über die Eigenschaften, die allen Datenflusskomponenten gemeinsam sind.

In der folgenden Tabelle werden die benutzerdefinierten Eigenschaften der Excel-Quelle beschrieben. Alle Eigenschaften weisen Lese-/Schreibzugriff auf.

Eigenschaftsname

Datentyp

Beschreibung

AccessMode

Ganze Zahl

Der zum Zugreifen auf die Datenbank verwendete Modus. Die möglichen Werte sind Geöffnetes Rowset, Geöffnetes Rowset aus Variable, SQL-Befehl und SQL-Befehl aus Variable. Der Standardwert ist Geöffnetes Rowset.

CommandTimeout

Ganze Zahl

Die Anzahl der Sekunden, nach denen ein Befehl wegen eines Timeouts abgebrochen wird. Der Wert 0 steht für ein unbegrenztes Timeout.

Hinweis   Diese Eigenschaft ist nicht im Quellen-Editor für Excel verfügbar, kann jedoch mit dem Dialogfeld Erweiterter Editor festgelegt werden.

OpenRowset

Zeichenfolge

Der Name des Datenbankobjekts, das zum Öffnen eines Rowsets verwendet wird.

OpenRowsetVariable

Zeichenfolge

Die Variable, die den Namen des Datenbankobjekts enthält, das zum Öffnen eines Rowsets verwendet wird.

ParameterMapping

Zeichenfolge

Die Zuordnung von Parametern im SQL-Befehl zu Variablen.

SqlCommand

Zeichenfolge

Der auszuführende SQL-Befehl.

SqlCommandVariable

Zeichenfolge

Die Variable, die den auszuführenden SQL-Befehl enthält.

Die Ausgabe und die Ausgabespalten der Excel-Quelle verfügen nicht über benutzerdefinierte Eigenschaften.

Weitere Informationen finden Sie unter Excel-Quelle.

Benutzerdefinierte Eigenschaften der Flatfilequelle

Die Flatfilequelle verfügt sowohl über benutzerdefinierte Eigenschaften als auch über die Eigenschaften, die allen Datenflusskomponenten gemeinsam sind.

In der folgenden Tabelle werden die benutzerdefinierten Eigenschaften der Flatfilequelle beschrieben. Alle Eigenschaften weisen Lese-/Schreibzugriff auf.

Eigenschaftsname

Datentyp

Beschreibung

FileNameColumnName

Zeichenfolge

Der Name einer Ausgabespalte, die den Dateinamen enthält. Wenn kein Name angegeben wird, wird keine Ausgabespalte generiert, die den Dateinamen enthält.

HinweisHinweis
Diese Eigenschaft ist nicht im Quellen-Editor für Flatfiles verfügbar, kann jedoch mit dem Dialogfeld Erweiterter Editor festgelegt werden.

RetainNulls

Boolesch

Ein Wert, der angibt, ob NULL-Werte aus der Quelldatei als NULL-Werte beibehalten werden sollen, wenn die Daten vom Data Transformation-Pipelinemodul verarbeitet werden. Der Standardwert dieser Eigenschaft ist False.

Die Ausgabe der Flatfilequelle verfügt nicht über benutzerdefinierte Eigenschaften.

Die folgende Tabelle beschreibt die benutzerdefinierten Eigenschaften der Ausgabespalten der Flatfilequelle. Alle Eigenschaften weisen Lese-/Schreibzugriff auf.

Eigenschaftsname

Datentyp

Beschreibung

FastParse

Boolesch

Ein Wert, der angibt, ob die Spalte die schnelleren gebietsschemaneutralen Analyseroutinen von DTS oder die gebietsschemabezogenen Standardanalyseroutinen verwendet. Weitere Informationen finden Sie unter Schnelle Analyse und Standardanalyse. Der Standardwert dieser Eigenschaft ist False.

HinweisHinweis
Diese Eigenschaft ist nicht im Quellen-Editor für Flatfiles verfügbar, kann jedoch mit dem Dialogfeld Erweiterter Editor festgelegt werden.

Weitere Informationen finden Sie unter Flatfilequelle.

Benutzerdefinierte Eigenschaften der OLE DB-Quelle

Die OLE DB-Quelle verfügt sowohl über benutzerdefinierte Eigenschaften als auch über die Eigenschaften, die allen Datenflusskomponenten gemeinsam sind.

In der folgenden Tabelle werden die benutzerdefinierten Eigenschaften der OLE DB-Quelle beschrieben. Alle Eigenschaften weisen Lese-/Schreibzugriff auf.

Eigenschaftsname

Datentyp

Beschreibung

AccessMode

Ganze Zahl

Der zum Zugreifen auf die Datenbank verwendete Modus. Die möglichen Werte sind Geöffnetes Rowset, Geöffnetes Rowset aus Variable, SQL-Befehl und SQL-Befehl aus Variable. Der Standardwert ist Geöffnetes Rowset.

AlwaysUseDefaultCodePage

Boolesch

Ein Wert, der angibt, ob der Wert der DefaultCodePage-Eigenschaft für jede Spalte verwendet werden soll oder ob versucht werden soll, die Codepage aus dem Gebietsschema jeder Spalte abzurufen. Der Standardwert dieser Eigenschaft ist False.

CommandTimeout

Ganze Zahl

Die Anzahl der Sekunden, nach denen ein Befehl wegen eines Timeouts abgebrochen wird. Der Wert 0 steht für ein unbegrenztes Timeout.

HinweisHinweis
Diese Eigenschaft ist nicht im Quellen-Editor für OLE DB verfügbar, kann jedoch mit dem Dialogfeld Erweiterter Editor festgelegt werden.

DefaultCodePage

Ganze Zahl

Die zu verwendende Codepage, wenn keine Codepageinformationen aus der Datenquelle verfügbar sind.

OpenRowset

Zeichenfolge

Der Name des Datenbankobjekts, das zum Öffnen eines Rowsets verwendet wird.

OpenRowsetVariable

Zeichenfolge

Die Variable, die den Namen des Datenbankobjekts enthält, das zum Öffnen eines Rowsets verwendet wird.

ParameterMapping

Zeichenfolge

Die Zuordnung von Parametern im SQL-Befehl zu Variablen.

SqlCommand

Zeichenfolge

Der auszuführende SQL-Befehl.

SqlCommandVariable

Zeichenfolge

Die Variable, die den auszuführenden SQL-Befehl enthält.

Die Ausgabe und die Ausgabespalten der OLE DB-Quelle verfügen nicht über benutzerdefinierte Eigenschaften.

Weitere Informationen finden Sie unter OLE DB-Quelle.

Benutzerdefinierte Eigenschaften der Rohdatendatei-Quelle

Die Rohdatendatei-Quelle verfügt sowohl über benutzerdefinierte Eigenschaften als auch über die Eigenschaften, die allen Datenflusskomponenten gemeinsam sind.

In der folgenden Tabelle werden die benutzerdefinierten Eigenschaften der Rohdatendatei-Quelle beschrieben. Alle Eigenschaften weisen Lese-/Schreibzugriff auf.

Eigenschaftsname

Datentyp

Beschreibung

AccessMode

Ganze Zahl (Enumeration)

Der zum Zugreifen auf die Rohdaten verwendete Modus. Die möglichen Werte sind File name (0) und File name from variable (1). Der Standardwert ist File name (0).

FileName

String

Der Pfad und der Dateiname der Quelldatei.

Die Ausgabe und die Ausgabespalten der Rohdatendatei-Quelle verfügen nicht über benutzerdefinierte Eigenschaften.

Weitere Informationen finden Sie unter Rohdatendatei-Quelle.

Benutzerdefinierte Eigenschaften der XML-Quelle

Die XML-Quelle verfügt sowohl über benutzerdefinierte Eigenschaften als auch über die Eigenschaften, die allen Datenflusskomponenten gemeinsam sind.

In der folgenden Tabelle werden die benutzerdefinierten Eigenschaften der XML-Quelle beschrieben. Alle Eigenschaften weisen Lese-/Schreibzugriff auf.

Eigenschaftsname

Datentyp

Beschreibung

AccessMode

Ganze Zahl

Der zum Zugreifen auf die XML-Daten verwendete Modus.

UseInlineSchema

Boolesch

Ein Wert, der angibt, ob eine Inlineschemadefinition innerhalb der XML-Quelle verwendet werden soll. Der Standardwert dieser Eigenschaft ist False.

XMLData

Zeichenfolge

Die Datei oder die Variablen, aus der bzw. denen die XML-Daten abgerufen werden sollen.

Der Wert dieser Eigenschaft kann mithilfe eines Eigenschaftsausdrucks angegeben werden.

XMLSchemaDefinition

Zeichenfolge

Der Pfad und der Dateiname der Schemadefinitionsdatei (.xsd).

Der Wert dieser Eigenschaft kann mithilfe eines Eigenschaftsausdrucks angegeben werden.

Die folgende Tabelle beschreibt die benutzerdefinierten Eigenschaften der Ausgabe der XML-Quelle. Alle Eigenschaften weisen Lese-/Schreibzugriff auf.

Eigenschaftsname

Datentyp

Beschreibung

RowsetID

Zeichenfolge

Ein Wert, der das der Ausgabe zugeordnete Rowset identifiziert.

Die Ausgabespalten der XML-Quelle verfügen nicht über benutzerdefinierte Eigenschaften.

Weitere Informationen finden Sie unter XML-Quelle.

Änderungsverlauf

Aktualisierter Inhalt

  • Numerische Werte für die AccessMode-Eigenschaft der Rohdatendatei-Quelle hinzugefügt.