Das XML-Format in Azure Data Factory- und Synapse Analytics-Pipelines

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Verwenden Sie diesen Artikel, wenn Sie die XML-Dateien analysieren möchten.

Das XML-Format wird für die folgenden Connectors unterstützt: Amazon S3, Kompatibler Amazon S3-Speicher, Azure Blob, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2, Azure Files, Dateisystem, FTP, Google Cloud Storage, HDFS, HTTP, Oracle Cloud Storage und SFTP. Es wird als Quelle, aber nicht als Senke unterstützt.

Dataset-Eigenschaften

Eine vollständige Liste mit den Abschnitten und Eigenschaften, die zum Definieren von Datasets zur Verfügung stehen, finden Sie im Artikel zu Datasets. Dieser Abschnitt enthält eine Liste der Eigenschaften, die vom XML-Dataset unterstützt werden.

Nachfolgend sehen Sie ein Beispiel für ein XML-Dataset in Azure Blob Storage:

{
    "name": "XMLDataset",
    "properties": {
        "type": "Xml",
        "linkedServiceName": {
            "referenceName": "<Azure Blob Storage linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties": {
            "location": {
                "type": "AzureBlobStorageLocation",
                "container": "containername",
                "folderPath": "folder/subfolder",
            },
            "compression": {
                "type": "ZipDeflate"
            }
        }
    }
}

Eigenschaften der Kopieraktivität

Eine vollständige Liste mit den Abschnitten und Eigenschaften zum Definieren von Aktivitäten finden Sie im Artikel Pipelines. Dieser Abschnitt enthält eine Liste der Eigenschaften, die von der XML-Quelle unterstützt werden.

Erfahren Sie, wie Sie XML-Daten und Senkendatenspeicher sowie das zugehörige Format aus der Schemazuordnung zuordnen. Beim Anzeigen einer Vorschau der XML-Dateien werden Daten in der JSON-Hierarchie angezeigt, und Sie verweisen über den JSON-Pfad auf die Felder.

XML als Quelle

Die folgenden Eigenschaften werden im Abschnitt *source* der Kopieraktivität unterstützt. Weitere Informationen finden Sie unter Verhalten des XML-Connectors.

Unterstützte XML-Leseeinstellungen unter formatSettings:

Eigenschaften von Mapping Data Flow

In Zuordnungsdatenflüssen können Sie das XML-Format in den folgenden Datenspeichern lesen: Azure Blob Storage, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2, Amazon S3 und SFTP. Sie können auf XML-Dateien mit einem XML-Dataset oder einem Inlinedataset verweisen.

Quelleigenschaften

In der folgenden Tabelle sind die von einer XML-Quelle unterstützten Eigenschaften aufgeführt. Sie können diese Eigenschaften auf der Registerkarte Quelloptionen bearbeiten. Weitere Informationen finden Sie unter Verhalten des XML-Connectors. Bei Verwendung eines Inlinedatasets werden zusätzliche Dateieinstellungen angezeigt. Diese entsprechen den Eigenschaften, die im Abschnitt zu den Dataseteigenschaften beschrieben sind.

Skriptbeispiel für XML-Quelle

Das nachstehende Skript stellt ein Beispiel für eine XML-Quellkonfiguration in Zuordnungsdatenflüssen per Datasetmodus dar.

source(allowSchemaDrift: true,
    validateSchema: false,
    validationMode: 'xsd',
    namespaces: true) ~> XMLSource

Das nachstehende Skript stellt ein Beispiel für eine XML-Quellkonfiguration mit dem Inline-Datasetmodus dar.

source(allowSchemaDrift: true,
    validateSchema: false,
    format: 'xml',
    fileSystem: 'filesystem',
    folderPath: 'folder',
    validationMode: 'xsd',
    namespaces: true) ~> XMLSource

Verhalten des XML-Connectors

Beachten Sie Folgendes, wenn Sie XML als Quelle verwenden.

• XML-Attribute:

  • Attribute eines Elements werden als untergeordnete Felder des Elements in der Hierarchie analysiert.
  • Der Name des Attributfelds folgt dem Muster @attributeName.

• XML-Schemaüberprüfung:

  • Sie können entscheiden, das Schema nicht zu überprüfen oder die Überprüfung mithilfe von XSD oder DTD durchzuführen.
  • Wenn Sie XSD oder DTD zum Überprüfen von XML-Dateien verwenden, muss in den XML-Dateien über den relativen Pfad auf die XSD-/DTD-Datei verwiesen werden.

• Namespaceverarbeitung:

  • Der Namespace kann bei Verwendung von Datenflüssen deaktiviert werden. In diesem Fall werden die Attribute, die den Namespace definieren, als normale Attribute analysiert.
  • Wenn der Namespace aktiviert ist, folgen die Namen der Elemente und Attribute standardmäßig den Mustern namespaceUri,elementName und namespaceUri,@attributeName. Sie können ein Namespacepräfix für jeden Namespace-URI in der Quelle definieren. In diesem Fall folgen die Namen der Elemente und Attribute stattdessen den Mustern definedPrefix:elementName oder definedPrefix:@attributeName.

• Wertspalte:

  • Wenn ein XML-Element sowohl einen einfachen Textwert als auch Attribute und untergeordnete Elemente aufweist, wird der einfache Textwert als Wert einer „Wertspalte“ mit dem integrierten Feldnamen _value_ analysiert. Außerdem erbt er ggf. den Namespace des Elements.

Zugehöriger Inhalt

• Kopieraktivität – Übersicht
• Mapping Data Flow
• Lookup-Aktivität
• GetMetadata-Aktivität