Format XML di alur Azure Data Factory dan Synapse Analytics

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Ikuti artikel ini saat Anda ingin memilah file XML.

Format XML didukung untuk konektor berikut: Amazon S3, Penyimpanan yang Kompatibel dengan Amazon S3, 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 dan SFTP. Ini didukung sebagai sumber tetapi tidak sebagai sink.

Properti himpunan data

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan himpunan data, lihat artikel Himpunan Data. Bagian ini menyediakan daftar properti yang didukung oleh himpunan data XML.

Di bawah ini adalah contoh himpunan data XML di 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"
            }
        }
    }
}

Properti aktivitas salin

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat artikel Alur. Bagian ini menyediakan daftar properti yang didukung oleh sumber XML.

Pelajari tentang cara memetakan data XML dan men-sink penyimpanan/format data dari pemetaan skema. Saat melihat pratinjau file XML, data ditunjukkan dengan hierarki JSON, dan Anda menggunakan jalur JSON untuk menunjuk ke bidang.

XML sebagai sumber

Properti berikut didukung di bagian *sumber* aktivitas salin. Pelajari lebih lanjut di perilaku konektor XML.

Pengaturan baca XML yang didukung di bawah formatSettings:

Properti pemetaan aliran data

Dalam memetakan aliran data, Anda dapat membaca format Excel pada penyimpanan data berikut: Azure Blob Storage, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2, Amazon S3 serta SFTP. Anda dapat mengarahkan ke file XML baik menggunakan himpunan data XML atau menggunakan himpunan data sebaris.

Properti sumber

Tabel di bawah ini mencantumkan properti yang didukung oleh sumber XML. Anda dapat mengedit properti ini di tab opsi Sumber. Pelajari lebih lanjut di perilaku konektor XML. Saat menggunakan himpunan data sebaris, Anda akan melihat pengaturan file tambahan, yang sama dengan properti yang dijelaskan di bagian properti himpunan data.

Contoh skrip sumber XML

Skrip di bawah ini adalah contoh konfigurasi sumber XML dalam alur pemetaan data menggunakan mode himpunan data.

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

Skrip di bawah ini adalah contoh konfigurasi sumber XML menggunakan mode himpunan data sebaris.

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

Perilaku konektor XML

Perhatikan hal berikut saat menggunakan XML sebagai sumber.

• Atribut XML:

  • Atribut suatu elemen dipilah sebagai sub-bidang dari elemen tersebut dalam hierarki.
  • Nama bidang atribut mengikuti pola @attributeName.

• Validasi skema XML:

  • Anda dapat memilih untuk tidak memvalidasi skema, atau memvalidasi skema menggunakan XSD atau DTD.
  • Saat menggunakan XSD atau DTD untuk memvalidasi file XML, XSD/DTD harus dirujuk ke dalam file XML melalui jalur relatif.

• Penanganan namespace layanan:

  • Namespace dapat dinonaktifkan saat menggunakan aliran data, dalam hal ini, atribut yang menentukan namespace layanan akan diuraikan sebagai atribut normal.
  • Saat namespace layanan diaktifkan, nama elemen dan atribut mengikuti pola namespaceUri,elementName dan namespaceUri,@attributeName secara default. Anda dapat menentukan prefiks namespace layanan untuk setiap URI namespace di sumber, dalam hal ini, nama elemen dan atribut malah mengikuti pola definedPrefix:elementName atau definedPrefix:@attributeName.

• Kolom nilai:

  • Jika elemen XML memiliki nilai teks sederhana dan atribut/elemen turunan, nilai teks sederhana diuraikan sebagai nilai "kolom nilai" dengan nama bidang bawaan _value_. Dan jika berlaku, ia juga mewarisi namespace layanan dari elemen.

Konten terkait

• Ringkasan aktivitas salin
• Alur pemetaan data
• Aktivitas pencarian
• Aktivitas GetMetadata