Dataflödesdefinition

Den här artikeln innehåller en uppdelning av definitionsstrukturen för dataflödesobjekt.

Definitionsdelar

Definitionsdelssökväg typ Krävs Beskrivning
queryMetadata.json Metadata ContentDetails (JSON) sann Beskriver metadata som rör frågealternativ i dataflödet
mashup.pq Mashup ContentDetails (PQ) sann Beskriver kombinationsinnehållet i nyttolasten. Den innehåller sekvens av alla steg som utförs i dataflödet
<mdfTransformName>.mdf MDFTransform ContentDetails (JSON) falskt Beskriver MDF-transformeringsinnehållet (Mapping Data Flow) för nyttolasten. Det kan finnas flera MDF-transformeringar i ett dataflöde

Metadata ContentDetails

Beskriver innehållet i nyttolasten

Namn Typ Krävs Beskrivning
formatVersion Sträng sann Version av dataflödesobjektformat. Det enda tillåtna värdet är 202502
namn Sträng sann Namnet på kombinationsrutan
computeEngineSettings ComputeEngineSettings falskt Inställningarna för beräkningsmotorn
queryGroups QueryGroup[] falskt Frågegrupper
documentLocale Sträng falskt Dokumentets nationella inställningar. måste vara BCP-47-språkkoder
gatewayObjectId Sträng falskt Gateway-objekt-ID
queriesMetadata QueriesMetadata falskt Frågor metadata
Anslutningar Anslutning[] falskt Användaranslutningar
fastCombine Boolesk falskt Anger om snabb kombination ska användas eller inte. Sant – använd snabb kombination. Falskt (standard) – använd inte snabb kombination
allowNativeQueries Boolesk falskt Anger om interna frågor tillåts eller inte. Sant (standard) – tillåt interna frågor. Falskt – tillåt inte interna frågor
skipAutomaticTypeAndHeaderDetection Boolesk falskt Anger om du vill hoppa över automatisk typ- och rubrikidentifiering eller inte. Sant – hoppa över identifiering. Falskt (standard) – hoppa inte över identifiering
parametrisk Boolesk falskt Anger om parametriskt läge används eller inte. Sant – parametriskt läge används. Falskt (standard) – parametriskt läge används inte

ComputeEngineSettings-innehåll

Namn Typ Krävs Beskrivning
allowFastCopy Boolesk falskt Anger om snabb kopiering är aktiverat eller inte. Sant (standard) – tillåt snabb kopiering. Falskt – Tillåt inte snabb kopiering
maxConcurrency Heltal falskt Det maximala antalet samtidiga utvärderingar som ska användas vid körning av dataflödet

QueryGroups-innehåll

Namn Typ Krävs Beskrivning
Id-nummer Sträng falskt ID för frågegruppen
namn Sträng falskt Namnet på frågegruppen
beskrivning Sträng falskt Beskrivningen av frågegruppen
parentId Sträng falskt Det överordnade ID:t för frågegruppen
beställning Heltal falskt Frågegruppens ordning

QueriesMetadata-innehåll

Namn Typ Krävs Beskrivning
queryId Sträng sann Fråge-ID
queryName Sträng sann Frågans namn
queryGroupId Sträng falskt Frågegrupps-ID
isHidden Boolesk falskt Anger om frågan är dold eller inte. Sant – frågan är dold. Falskt (standard) – frågan är inte dold
loadEnabled Boolesk falskt Anger om inläsning är aktiverat eller inte. Sant (standard) – inläsning är aktiverat. Falskt – inläsningen är inte aktiverad

Anslutningsinnehåll

Namn Typ Krävs Beskrivning
väg Sträng falskt Anslutningssökvägen
sort Sträng falskt Anslutningstypen
connectionId Sträng falskt Anslutnings-ID:t

Exempel på Metadata ContentDetails

{
  "formatVersion": "202502",
  "computeEngineSettings": {
    "allowFastCopy": true,
    "maxConcurrency": 1
  },
  "name": "SampleDataflowGen",
  "queryGroups": [
    
  ],
  "documentLocale": "en-US",
  "gatewayObjectId": null,
  "queriesMetadata": {
    "publicholidays": {
      "queryId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
      "queryName": "publicholidays",
      "queryGroupId": null,
      "isHidden": false,
      "loadEnabled": true
    },
    "MDF transform": {
      "queryId": "9c6d7c87-83db-4718-b382-c0c1aa1636d7",
      "queryName": "MDF transform",
      "loadEnabled": false
    }
  },
  "connections": [
    {
      "path": "Lakehouse",
      "kind": "Lakehouse",
      "connectionId": "{\"ClusterId\":\"b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2\",\"DatasourceId\":\"c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3\"}"
    }
  ],
  "fastCombine": false,
  "allowNativeQueries": true,
  "skipAutomaticTypeAndHeaderDetection": false
}

Exempel på KombinationsinnehållDetails

[StagingDefinition = [Kind = "FastCopy"]]
section Section1;
shared publicholidays = 
let  Source = Lakehouse.Contents([]),  
#"Navigation 1" = Source{[workspaceId = "d3d3d3d3-eeee-ffff-aaaa-b4b4b4b4b4b4"]}[Data],  
#"Navigation 2" = #"Navigation 1"{[lakehouseId = "e4e4e4e4-ffff-aaaa-bbbb-c5c5c5c5c5c5"]}[Data],  
#"Navigation 3" = #"Navigation 2"{[Id = "publicholidays", ItemKind = "Table"]}[Data],  
#"Changed column type" = Table.TransformColumnTypes(#"Navigation 3", {{"normalizeHolidayName", type text}}),  
#"Lowercased text" = Table.TransformColumns(#"Changed column type", {{"countryRegionCode", each Text.Lower(_), type nullable text}}),  
#"Uppercased text" = Table.TransformColumns(#"Lowercased text", {{"normalizeHolidayName", each Text.Upper(_), type nullable text}}),  
#"Calculated text length" = Table.TransformColumns(#"Uppercased text", {{"countryOrRegion", each Text.Length(_), type nullable Int64.Type}})in  #"Calculated text length";
[ItemType = "MDF"]
shared #"MDF transform" = "___ExternalResource-Placeholder___";

MDFTransform ContentDetails

Beskriver innehållet i en mappning Data Flow nyttolast.

Namn Typ Krävs Beskrivning
namn Sträng sann Namnet på dataflödet för mappning
properties Egenskaper sann Egenskaperna för dataflödet för mappning

Innehåll för MDFTransform-egenskaper

Namn Typ Krävs Beskrivning
typ Sträng sann Typ av dataflöde. Det tillåtna värdet är MappingDataFlow
typeProperties TypeProperties sann Typegenskaperna för mappningsdataflödet

MDFTransform TypeProperties-innehåll

Namn Typ Krävs Beskrivning
Källor Källa[] falskt Listan över källor i dataflödet för mappning
sinks Mottagare[] falskt Listan över mottagare i dataflödet för mappning
transformations Transformering[] falskt Listan över transformeringar i dataflödet för mappning
scriptLines (på engelska) Sträng[] sann Skriptraderna som definierar logiken för dataflödesmappning

MDFTransform-källinnehåll

Namn Typ Krävs Beskrivning
namn Sträng sann Källans namn
externalReferences ExternalReferences falskt De externa referenserna för källan

Innehåll för MDFTransform-mottagare

Namn Typ Krävs Beskrivning
namn Sträng sann Namnet på mottagaren
externalReferences ExternalReferences falskt De externa referenserna för mottagaren

MDFTransform-transformeringsinnehåll

Namn Typ Krävs Beskrivning
namn Sträng sann Namnet på omvandlingen

MDFTransform ExternalReferences-innehåll

Namn Typ Krävs Beskrivning
connection Sträng falskt Anslutnings-ID för den externa referensen

MDFTransform ContentDetails-exempel

{
  "name": "MDF",
  "properties": {
    "type": "MappingDataFlow",
    "typeProperties": {
      "sources": [
        {
          "name": "source1",
          "externalReferences": {
            "connection": "<source1ConnectionId>"
          }
        }
      ],
      "sinks": [
        {
          "name": "sink1",
          "externalReferences": {
            "connection": "<sink1ConnectionId>"
          }
        }
      ],
      "transformations": [
        {
          "name": "derivedColumn1"
        }
      ],
      "scriptLines": [
        "source(output(",
        "          Column1 as short,",
        "          Column2 as string,",
        "          Column3 as date,",
        "          Column4 as boolean,",
        "          Column5 as string,",
        "          Column6 as double",
        "     ),",
        "     useSchema: false,",
        "     allowSchemaDrift: true,",
        "     validateSchema: false,",
        "     ignoreNoFilesFound: false,",
        "     format: 'delimited',",
        "     fileSystem: 'folder1',",
        "     fileName: 'file1.csv',",
        "     columnDelimiter: ',',",
        "     escapeChar: '\\\\',",
        "     quoteChar: '\\\"',",
        "     columnNamesAsHeader: true) ~> source1",
        "source1 derive(isColumn6GreaterThan10 = Column6>10) ~> derivedColumn1",
        "derivedColumn1 sink(allowSchemaDrift: true,",
        "     validateSchema: false,",
        "     format: 'json',",
        "     fileSystem: 'output1',",
        "     umask: 0022,",
        "     preCommands: [],",
        "     postCommands: [],",
        "     skipDuplicateMapInputs: true,",
        "     skipDuplicateMapOutputs: true) ~> sink1"
      ]
    }
  }
}