Freigeben über


XML-Quelle

Die XML-Quelle liest eine XML-Datendatei und füllt die Spalten in der Quellausgabe mit den Daten.

Die Daten in XML-Dateien schließen häufig hierarchische Beziehungen ein. Beispielsweise kann eine XML-Datendatei Kataloge und Katalogelemente darstellen. Bevor die Daten in den Datenfluss aufgenommen werden können, muss die Beziehung der Elemente in der XML-Datendatei bestimmt werden, und für jedes Dateielement muss eine Ausgabe generiert werden.

Schemas

Die XML-Quelle verwendet ein Schema zum Interpretieren der XML-Daten. Die XML-Quelle unterstützt die Verwendung von XSD-Dateien (XML Schema Definition) oder Inlineschemas, um die XML-Daten in das Tabellenformat zu übersetzen. Wenn Sie die XML-Quelle mithilfe des Dialogfelds Quellen-Editor für XML konfigurieren, kann die Benutzeroberfläche XSD-Code von der angegebenen XML-Datendatei generieren.

Hinweis

DTDs werden nicht unterstützt.

Von den Schemas wird nur ein einziger Namespace unterstützt. Schemaauflistungen werden nicht unterstützt.

Hinweis

Die XML-Quelle überprüft die Daten in der XML-Datei nicht mit dem XSD-Code.

Quellen-Editor für XML

Die Daten in XML-Dateien schließen häufig hierarchische Beziehungen ein. Im Dialogfeld Quellen-Editor für XML wird das angegebene Schema zum Generieren der XML-Quellausgaben verwendet. Sie können eine XSD-Datei angeben, ein Inlineschema verwenden oder XSD-Code von der angegebenen XML-Datendatei generieren. Das Schema muss zur Entwurfszeit verfügbar sein.

Die XML-Quelle generiert von den XML-Daten Tabellenstrukturen, indem sie eine Ausgabe für jedes Element erstellt, das andere Elemente in den XML-Dateien enthält. Wenn z. B. die XML-Daten Kataloge und Katalogelemente darstellen, erstellt die XML-Quelle eine Ausgabe für Kataloge und eine Ausgabe für jeden Elementtyp, der in den Katalogen enthalten ist. Die Ausgabe jedes Elements enthält Ausgabespalten für die Attribute dieses Elements.

Um Informationen zur hierarchischen Beziehung der Daten in den Ausgaben bereitzustellen, fügt die XML-Quelle in den Ausgaben eine Spalte hinzu, die das übergeordnete Element für jedes untergeordnete Element identifiziert. Für das Beispiel der Kataloge mit unterschiedlichen Elementtypen hätte jedes Element einen Spaltenwert, der den zugehörigen Katalog identifiziert.

Die XML-Quelle erstellt für jedes Element eine Ausgabe, aber es ist nicht erforderlich alle Ausgaben zu verwenden. Sie können jede Ausgabe löschen, die Sie nicht verwenden möchten, oder sie einfach nicht mit einer Downstreamkomponente verbinden.

Die XML-Quelle generiert außerdem die Ausgabenamen, um sicherzustellen, dass die Namen eindeutig sind. Es könnte sich um lange Namen handeln, mit denen die Ausgaben für Sie nicht sinnvoll identifiziert werden. Sie können die Ausgaben umbenennen, vorausgesetzt die Namen bleiben eindeutig. Außerdem können Sie den Datentyp und die Länge der Ausgabespalten ändern.

Für jede Ausgabe fügt die XML-Quelle eine Fehlerausgabe hinzu. Standardmäßig weisen die Spalten in Fehlerausgaben den Unicode-Zeichenfolgen-Datentyp (DT_WSTR) mit einer Länge von 255 auf. Sie können jedoch die Spalten in den Fehlerausgaben konfigurieren, indem Sie deren Datentyp und Länge ändern.

Falls die XML-Datendatei Elemente enthält, die nicht im XSD-Code vorhanden sind, werden diese ignoriert und es wird keine Ausgabe dafür generiert. Wenn andererseits in der XML-Datendatei Elemente fehlen, die im XSD-Code dargestellt sind, enthält die Ausgabe Spalten mit NULL-Werten.

Wenn die Daten aus der XML-Datendatei extrahiert werden, werden sie in einen Integration Services-Datentyp konvertiert. Die XML-Quelle kann XML-Daten jedoch nicht in die Datentypen DT_TIME2 oder DT_DBTIMESTAMP2 konvertieren, da diese Datentypen nicht von der Quelle unterstützt werden. Weitere Informationen finden Sie unter Integration Services Datentypen.

Im XSD-Code oder Inlineschema kann der Datentyp für Elemente angegeben sein. Andernfalls weist der Quellen-Editor für XML der Spalte in der Ausgabe, die das Element enthält, den Unicode-Zeichenfolgen-Datentyp (DT_WSTR) zu und legt als Spaltenlänge 255 Zeichen fest.

Wenn im Schema die maximale Länge eines Elements angegeben ist, wird die Länge der Ausgabespalte auf diesen Wert festgelegt. Falls die Länge die maximal unterstützte Länge des Integration Services-Datentyps überschreitet, in den das Element konvertiert wird, werden die Daten auf die maximal zulässige Länge des Datentyps gekürzt. Besitzt z. B. eine Zeichenfolge die Länge 5000, wird sie auf 4000 Zeichen abgeschnitten, da die maximale Länge des DT_WSTR-Datentyps 4000 Zeichen beträgt. Ebenso werden Bytedaten auf 8000 Zeichen, die maximale Länge des DT_BYTES-Datentyps, abgeschnitten. Wenn im Schema keine maximale Länge angegeben ist, wird die Standardlänge von Spalten mit einem der Datentypen auf 255 festgelegt. Das Abschneiden von Daten in der XML-Quelle wird auf die gleiche Weise gehandhabt wie das Abschneiden in anderen Datenflusskomponenten. Weitere Informationen finden Sie unter Fehlerbehandlung in Daten.

Sie können den Datentyp und die Spaltenlänge ändern. Weitere Informationen finden Sie unter Integration Services Datentypen.

Konfiguration der XML-Quelle

Die XML-Quelle unterstützt drei verschiedene Datenzugriffsmodi. Sie können den Dateispeicherort der XML-Datendatei, eine Variable mit dem Dateispeicherort oder eine Variable mit den XML-Daten angeben.

Die XML-Quelle schließt die benutzerdefinierten Eigenschaften XMLData und XMLSchemaDefinition ein, die beim Laden des Pakets mithilfe von Eigenschaftsausdrücken aktualisiert werden können. Weitere Informationen finden Sie unter Integration Services-Ausdrücke (SSIS), Verwenden von Eigenschaftsausdrücken in Paketen und Benutzerdefinierte Eigenschaften der XML-Quelle.

Die XML-Quelle unterstützt mehrere reguläre Ausgaben und Fehlerausgaben.

SQL Server Integration Services umfasst das Dialogfeld Quellen-Editor für XML zum Konfigurieren der XML-Quelle. Dieses Dialogfeld steht im SSIS-Designer zur Verfügung.

Sie können Eigenschaften mit dem SSIS -Designer oder programmgesteuert festlegen.

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im Dialogfeld Quellen-Editor für XML festlegen können:

Das Dialogfeld Erweiterter Editor enthält die Eigenschaften, die programmgesteuert festgelegt werden können. Klicken Sie auf eines der folgenden Themen, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im Dialogfeld Erweiterter Editor oder programmgesteuert festlegen können:

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zum Festlegen der Eigenschaften anzuzeigen:

Extrahieren von Daten mithilfe der XML-Quelle

Technischer Artikel : Verwenden einer XML-Datei zum Konfigurieren eines SSIS-Pakets.