XML-format i Azure Data Factory- och Synapse Analytics-pipelines

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Följ den här artikeln när du vill parsa XML-filerna.

XML-format stöds för följande anslutningsappar: Amazon S3, Amazon S3 Compatible Storage, Azure Blob, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2, Azure Files, File System, FTP, Google Cloud Storage, HDFS, HTTP, Oracle Cloud Storage och SFTP. Det stöds som källa men inte mottagare.

Egenskaper för datauppsättning

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i artikeln Datauppsättningar . Det här avsnittet innehåller en lista över egenskaper som stöds av XML-datauppsättningen.

Nedan visas ett exempel på XML-datauppsättning i 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"
            }
        }
    }
}

Kopiera egenskaper för aktivitet

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i artikeln Pipelines . Det här avsnittet innehåller en lista över egenskaper som stöds av XML-källan.

Lär dig mer om hur du mappar XML-data och datalager/format för mottagare från schemamappning. När du förhandsgranskar XML-filer visas data med JSON-hierarki och du använder JSON-sökvägen för att peka på fälten.

XML som källa

Följande egenskaper stöds i avsnittet kopieringsaktivitet *källa* . Läs mer om XML-anslutningsbeteende.

Xml-läsinställningar som stöds under formatSettings:

Mappa dataflödesegenskaper

När du mappar dataflöden kan du läsa XML-format i följande datalager: Azure Blob Storage, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2, Amazon S3 och SFTP. Du kan peka på XML-filer antingen med hjälp av XML-datamängd eller med hjälp av en infogad datauppsättning.

Källegenskaper

Tabellen nedan visar de egenskaper som stöds av en XML-källa. Du kan redigera de här egenskaperna på fliken Källalternativ . Läs mer om XML-anslutningsbeteende. När du använder infogad datauppsättning visas ytterligare filinställningar, som är samma som egenskaperna som beskrivs i avsnittet egenskaper för datamängd.

Exempel på XML-källskript

Skriptet nedan är ett exempel på en XML-källkonfiguration i mappning av dataflöden med hjälp av datauppsättningsläge.

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

Skriptet nedan är ett exempel på en XML-källkonfiguration med hjälp av infogat datauppsättningsläge.

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

XML-anslutningsbeteende

Observera följande när du använder XML som källa.

• XML-attribut:

  • Attribut för ett element parsas som underfält för elementet i hierarkin.
  • Namnet på attributfältet följer mönstret @attributeName.

• XML-schemaverifiering:

  • Du kan välja att inte validera schemat eller verifiera schemat med XSD eller DTD.
  • När du använder XSD eller DTD för att validera XML-filer måste XSD/DTD refereras i XML-filerna via relativ sökväg.

• Namnområdeshantering:

  • Namnområdet kan inaktiveras när du använder dataflöde, i vilket fall attributen som definierar namnområdet parsas som normala attribut.
  • När namnområdet är aktiverat följer namnen på elementet och attributen mönstret namespaceUri,elementName och namespaceUri,@attributeName som standard. Du kan definiera namnområdesprefix för varje namnområdes-URI i källan, i vilket fall namnen på elementet och attributen följer mönstret definedPrefix:elementName eller definedPrefix:@attributeName i stället.

• Värdekolumn:

  • Om ett XML-element har både enkelt textvärde och attribut/underordnade element parsas det enkla textvärdet som värdet för en "värdekolumn" med det inbyggda fältnamnet _value_. Och det ärver även -elementets namnområde om det gäller.

Relaterat innehåll

• Översikt över kopieringsaktivitet
• Mappa dataflöden
• Sökningsaktivitet
• GetMetadata-aktivitet