Azure Data Factory 和 Synapse Analytics 管線中的 XML 格式

適用於：Azure Data Factory Azure Synapse Analytics

當您想要剖析 XML 檔案時，請遵循此文章。

下列連接器可支援 XML 格式：Amazon S3、Amazon S3 相容儲存體、Azure Blob、Azure Data Lake Storage Gen1、Azure Data Lake Storage Gen2、Azure 檔案儲存體、檔案系統、FTP、Google Cloud Storage、HDFS、HTTP、Oracle Cloud Storage 和 SFTP。 支援 Excel 格式作為來源，但不支援接收。

資料集屬性

如需可用來定義資料集的區段和屬性完整清單，請參閱資料集一文。 本節提供 XML 資料集所支援的屬性清單。

以下是 Azure Blob 儲存體上的 XML 資料集範例：

{
    "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"
            }
        }
    }
}

複製活動屬性

如需可用來定義活動的區段和屬性完整清單，請參閱管線一文。 本節提供 XML 來源所支援的屬性清單。

了解如何從結構描述對應對應 XML 資料和接收資料存放區/格式。 預覽 XML 檔案時，資料會以 JSON 階層顯示，且您會使用 JSON 路徑以指向欄位。

XML 做為來源

複製活動的 [來源] 區段支援下列屬性。 透過 XML 連接器行為深入了解。

支援的 XML 讀取設定位於 formatSettings 底下：

對應資料流程屬性

在對應資料流中，您可以在下列資料存放區讀取 XML 格式：Azure Blob 儲存體、Azure Data Lake Storage Gen1、Azure Data Lake Storage Gen2、Amazon S3 和 SFTP。 您可以使用 XML 資料集或內嵌資料集來指向 XML 檔案。

來源屬性

下表列出 XML 來源支援的屬性。 您可以在 [來源選項] 索引標籤中編輯這些屬性。透過 XML 連接器行為深入了解。 使用內嵌資料集時，您會看到其他檔案設定，其與資料集屬性一節所述的屬性相同。

XML 來源指令碼範例

下列指令碼是使用資料集模式的對應資料流中 XML 來源組態的範例。

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

下列指令碼是使用內嵌資料集模式的 XML 來源組態的範例。

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

XML 連接器行為

使用 XML 做為來源時，請注意下列事項。

• XML 屬性：

  • 元素的屬性會剖析為階層中元素的子欄位。
  • 屬性欄位的名稱會遵循模式 @attributeName。

• XML 結構描述驗證：

  • 您可以選擇不要驗證結構描述，或使用 XSD 或 DTD 驗證結構描述。
  • 使用 XSD 或 DTD 來驗證 XML 檔案時，必須在 XML 檔案內透過相對路徑參考 XSD/DTD。

• 命名空間處理：

  • 使用資料流程時可以停用命名空間，在此情況下，定義命名空間的屬性會剖析為一般屬性。
  • 啟用命名空間時，元素和屬性的名稱預設會遵循模式 namespaceUri,elementName 和 namespaceUri,@attributeName。 您可以在來源中為每個命名空間 URI 定義命名空間前置詞，在此情況下，元素和屬性的名稱會改為遵循模式 definedPrefix:elementName 或 definedPrefix:@attributeName。

• 值資料行：

  • 如果 XML 元素同時具有簡單文字值和屬性/子項目，則簡單文字值會剖析為具有內建欄位名稱 _value_ 的「值資料行」值。 而如果適用，它也會繼承元素的命名空間。

相關內容

• 複製活動概觀
• 對應資料流程
• 查閱活動
• GetMetadata 活動