インジェスト マッピング

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー

インジェスト マッピングは、インジェスト中に、受信データをテーブル内の列にマップするために使用されます。

データ エクスプローラーでは、行指向 (CSV、JSON、AVRO、W3CLOGFILE) と列指向 (Parquet および ORC) の両方の異なる種類のマッピングがサポートされています。

インジェスト マッピングは作成ingestionMappingReferenceパラメーターを使用して取り込みコマンドから参照できます。 マッピングを指定しなくてもインジェストが可能です。 詳細については、 識別マッピングを参照してください。

マッピング リスト内の各要素は、次の 3 つのフィールドから構成されます。

サポートされているマッピングの種類

次の表は、特定の形式の外部データの取り込みまたはクエリを実行するときに使用するマッピングの種類を定義します。

ID のマッピング

ingestionMapping または ingestionMappingReference プロパティを指定せずにインジェストを行うことができます。 データは、テーブルのスキーマから派生した ID データ マッピングを使用してマップされます。 テーブル スキーマは変わりません。 format プロパティを指定する必要があります ingestion 形式を参照してください。

マッピング変換

一部のデータ形式マッピング (Parquet、JSON、AVRO) では、単純で便利な取り込み時間変換がサポートされています。 取り込み時により複雑な処理を必要とするシナリオでは、更新ポリシーを使用します。これにより、KQL 式を使用した簡易処理が可能になります。

マッピング変換の例

DropMappedFields 変換：

次の JSON コンテンツを指定します。

{
    "Time": "2012-01-15T10:45",
    "Props": {
        "EventName": "CustomEvent",
        "Revenue": 0.456
    }
}

次のデータ マッピングでは、 Props オブジェクト全体が動的列 Props にマップされますが、既にマップされている列は除外されます (Props.EventName は既に列 EventNameにマップされているため、除外されます)。

[
    { "Column": "Time", "Properties": { "Path": "$.Time" } },
    { "Column": "EventName", "Properties": { "Path": "$.Props.EventName" } },
    { "Column": "Props", "Properties": { "Path": "$.Props", "Transform":"DropMappedFields" } },
]

取り込まれたデータは次のようになります。

BytesAsBase64 変換

次の AVRO ファイルの内容を指定します。

{
    "Time": "2012-01-15T10:45",
    "Props": {
        "id": [227,131,34,92,28,91,65,72,134,138,9,133,51,45,104,52]
    }
}

次のデータ マッピングは、変換の有無に関係なく、ID 列を 2 回マップします。

[
    { "Column": "ID", "Properties": { "Path": "$.props.id" } },
    { "Column": "Base64EncodedId", "Properties": { "Path": "$.props.id", "Transform":"BytesAsBase64" } },
]

取り込まれたデータは次のようになります。