XML-Quelle

Aktualisiert: 14. April 2006

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.

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 Dialogfeldes 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.

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 Referenzinformationen zu SQL Server Integration Services-Ausdrücken, Verwendung von Eigenschaftsausdrücken in Paketen und Source Custom Properties.

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

SQL Server 2005 Integration Services (SSIS) schließt das Dialogfeld Quellen-Editor für XML zum Konfigurieren der XML-Quelle ein. Dieses Dialogfeld steht im SSIS-Designer zur Verfügung.

Verwenden des Quellen-Editors 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 Datentyp von Integration Services konvertiert. 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. Ist die maximale Länge größer als die Länge, die von dem Integration Services-Datentyp unterstützt wird, in den das Element konvertiert wird, werden die Daten auf die maximale Länge des Datentyps abgeschnitten. 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. Ist im Schema keine maximale Länge angegeben, 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 behandelt wie das Abschneiden in anderen Datenflusskomponenten. Weitere Informationen finden Sie unter Behandeln von Fehlern in Daten.

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

Konfigurieren der XML-Quelle

Eigenschaften können Sie 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:

• Quellen-Editor für XML (Seite Verbindungs-Manager)
• Quellen-Editor für XML (Seite Spalten)
• Quellen-Editor für XML (Seite Fehlerausgabe)

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:

• Common Properties
• Source Custom Properties

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zum Festlegen von Eigenschaften zu erhalten:

• Vorgehensweise: Extrahieren von Daten mithilfe der XML-Quelle
• Vorgehensweise: Festlegen der Eigenschaften einer Datenflusskomponente mithilfe eines Komponenten-Editors
• Vorgehensweise: Festlegen der Eigenschaften einer Datenflusskomponente im Eigenschaftenfenster
• Vorgehensweise: Festlegen der Eigenschaften einer Datenflusskomponente mithilfe des erweiterten Editors

Siehe auch

Konzepte

Erstellen eines Paketdatenflusses

Andere Ressourcen

SQL Server Integration Services-Quellen

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version	Verlauf
14. April 2006	Neuer Inhalt: Informationen zum Abschneiden von Daten und zur Standardlänge von Spalten wurden hinzugefügt.
05. Dezember 2005	Neuer Inhalt: Informationen zu benutzerdefinierten Eigenschaften wurden hinzugefügt.