Azure Data Factoryおよび Synapse Analytics パイプラインの XML 形式

APPLIES TO: Azure Data Factory Azure Synapse Analytics

XML ファイルを解析する場合は、この記事に従ってください。

XML 形式は、次のコネクタでサポートされています:Xml 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、SFTP。 これはソースとしてはサポートされますが、シンクとしてはサポートされません。

データセットのプロパティ

データセットを定義するために使用できるセクションとプロパティの完全な一覧については、データセットに関する記事をご覧ください。 このセクションでは、XML データセットでサポートされるプロパティの一覧を示します。

Azure Blob Storage上の 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"
            }
        }
    }
}

プロパティのCopy アクティビティ

アクティビティの定義に利用できるセクションとプロパティの完全な一覧については、パイプラインに関する記事を参照してください。 このセクションでは、XML ソースでサポートされるプロパティの一覧を示します。

スキーマ マッピングから XML データとシンク データ ストア/形式をマップする方法について説明します。 XML ファイルをプレビューするときは、データは JSON 階層で表示され、JSON パスを使用してフィールドを参照します。

ソースとしての XML

Copy アクティビティの *source* セクションでは、次のプロパティがサポートされます。 詳細については、「XML コネクタの動作」を参照してください。

でサポートされている formatSettings:

Mapping Data Flow のプロパティ

マッピング データ フローでは、Azure Blob Storage、Azure Data Lake Storage Gen1、Azure Data Lake Storage Gen2、Xml S3、SFTP の各データ ストアで XML 形式を読み取ることができます>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 ファイルを検証する場合、XSD/DTD は、相対パスを使用して XML ファイル内で参照する必要があります。

• 名前空間の処理:

  • データ フローを使用するときに名前空間を無効にできます。その場合、名前空間を定義する属性は、通常の属性として解析されます。
  • 名前空間が有効になっている場合、要素と属性の名前は、既定で namespaceUri,elementName と namespaceUri,@attributeName のパターンに従います。 ソース内の名前空間 URI ごとに名前空間プレフィックスを定義できます。この場合、要素と属性の名前は、代わりに definedPrefix:elementName または definedPrefix:@attributeName のパターンに従います。

• 値列:

  • XML 要素に単純なテキスト値と属性/子要素の両方がある場合、単純なテキスト値は、組み込みフィールド名 _value_ を持つ "値列" の値として解析されます。 また、要素の名前空間も継承します (該当する場合)。

関連するコンテンツ

• Copy アクティビティの概要
• マッピング データ フロー
• Lookup アクティビティ
• GetMetadata アクティビティ