Dataflytdefinisjon

Denne artikkelen inneholder en oversikt over definisjonsstrukturen for dataflytelementer.

Definisjonsdeler

Definisjonsdelbane type Kreves Beskrivelse
queryMetadata.json Metadata ContentDetails (JSON) sann Beskriver metadata relatert til spørringsalternativer i dataflyt
mashup.pq Mashup ContentDetails (PQ) sann Beskriver innhold for nettfletting av nyttelast. Den inneholder sekvens av alle trinnene som utføres i dataflyten
<mdfTransformName>.mdf MDFTransform ContentDetails (JSON) falsk Beskriver tilordning Dataflyt (MDF) transformerer innhold i nyttelasten. Det kan være flere MDF-transformeringer i en dataflyt

Metadata ContentDetails

Beskriver innhold av nyttelast

Navn Type: Kreves Beskrivelse
formatVersion Streng sann Versjon av dataflytelementformat. Den eneste tillatte verdien er 202502
navn Streng sann Navnet på mashup-filen
computeEngineSettings ComputeEngineSettings falsk Innstillingene for databehandlingsmotoren
queryGroups QueryGroup[] falsk Spørringsgrupper
documentLocale Streng falsk Den nasjonale innstillingen for dokumentet. må være BCP-47-språkkoder
gatewayObjectId Streng falsk Objekt-ID-en for gatewayen
queriesMetadata QueriesMetadata falsk Spørringsmetadata
Tilkoblinger Tilkobling[] falsk Brukertilkoblinger
fastCombine boolsk falsk Angir om hurtigkombinering skal brukes eller ikke. Sann – bruk rask kombinering. Usann (standard) – ikke bruk hurtigkombinering
allowNativeQueries boolsk falsk Angir om opprinnelige spørringer er tillatt eller ikke. Sann (standard) – tillat opprinnelige spørringer. False – ikke tillat opprinnelige spørringer
skipAutomaticTypeAndHeaderDetection boolsk falsk Angir om automatisk type- og topptekstregistrering skal hoppe over eller ikke. Sann – hopp over gjenkjenning. Usann (standard) – ikke hopp over gjenkjenning
Parametrisk boolsk falsk Angir om parametrisk modus brukes eller ikke. Sann – parametrisk modus brukes. Usann (standard) – parametrisk modus brukes ikke

ComputeEngineSettings Contents

Navn Type: Kreves Beskrivelse
allowFastCopy boolsk falsk Angir om rask kopi er aktivert eller ikke. Sann (standard) – tillat rask kopi. False - Ikke tillat rask kopi
maxConcurrency Heltall falsk Maksimalt antall samtidige evalueringer som skal brukes ved kjøring av dataflyten

QueryGroups-innhold

Navn Type: Kreves Beskrivelse
ID Streng falsk ID-en for spørringsgruppen
navn Streng falsk Navnet på spørringsgruppen
beskrivelse Streng falsk Beskrivelsen av spørringsgruppen
parentId Streng falsk Den overordnede ID-en for spørringsgruppen
rekkefølge Heltall falsk Rekkefølgen på spørringsgruppen

Spørringsmetadatainnhold

Navn Type: Kreves Beskrivelse
queryId Streng sann Spørrings-ID-en
queryName Streng sann Navnet på spørringen
queryGroupId Streng falsk Spørringsgruppe-ID
isHidden boolsk falsk Angir om spørringen er skjult eller ikke. Sann – spørringen er skjult. Usann (standard) – spørringen er ikke skjult
loadEnabled boolsk falsk Angir om innlasting er aktivert eller ikke. Sann (standard) – innlasting er aktivert. Usann – innlasting er ikke aktivert

Tilkoblingsinnhold

Navn Type: Kreves Beskrivelse
bane Streng falsk Tilkoblingsbanen
snill Streng falsk Tilkoblingstypen
connectionId Streng falsk Tilkoblings-ID-en

Eksempel 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
}

Eksempel på Mashup ContentDetails

[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 innholdet i en tilordning Dataflyt nyttelast.

Navn Type: Kreves Beskrivelse
navn Streng sann Navnet på dataflyten for tilordning
Egenskaper Egenskaper sann Egenskapene for tilordningsdataflyten

Innhold for MDFTransform-egenskaper

Navn Type: Kreves Beskrivelse
type Streng sann Dataflyttypen. Den tillatte verdien er MappingDataFlow
typeProperties TypeProperties sann Typeegenskapene for tilordningsdataflyten

INNHOLD I MDFTransform TypeProperties

Navn Type: Kreves Beskrivelse
Kilder Kilde[] falsk Listen over kilder i dataflyten for tilordning
Synker Sink[] falsk Listen over vasker i dataflyten for tilordning
Transformasjoner Transformasjon[] falsk Listen over transformasjoner i dataflyten for tilordning
skriptlinjer String[] sann Skriptlinjene som definerer tilordning av dataflytlogikk

MDFTransform-kildeinnhold

Navn Type: Kreves Beskrivelse
navn Streng sann Navnet på kilden
externalReferences ExternalReferences falsk De eksterne referansene for kilden

MDFTransform Sink Contents

Navn Type: Kreves Beskrivelse
navn Streng sann Navnet på vasken
externalReferences ExternalReferences falsk De eksterne referansene for vasken

MDFTransform-transformasjonsinnhold

Navn Type: Kreves Beskrivelse
navn Streng sann Navnet på transformasjonen

INNHOLD I MDFTransform ExternalReferences

Navn Type: Kreves Beskrivelse
forbindelse Streng falsk Tilkoblings-ID-en for den eksterne referansen

MDFTransform ContentDetails-eksempel

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