Definizione del flusso di dati

Questo articolo fornisce una suddivisione della struttura di definizione per gli elementi del flusso di dati.

Parti di definizione

Percorso della parte di definizione tipo Obbligatorio Descrizione
queryMetadata.json metadati ContentDetails (JSON) vero Descrive i metadati correlati alle opzioni di query nel flusso di dati
mashup.pq Mashup ContentDetails (PQ) vero Descrive il contenuto mashup del payload. Contiene sequenza di tutti i passaggi eseguiti nel flusso di dati
<mdfTransformName>.mdf MDFTransform ContentDetails (JSON) falso Descrive il contenuto della trasformazione mdf (Mapping Flusso di dati) del payload. Possono essere presenti più trasformazioni MDF all'interno di un flusso di dati

ContentDetails dei metadati

Descrive il contenuto del payload

Nome TIPO Obbligatorio Descrizione
formatVersion Stringa vero Versione del formato dell'elemento del flusso di dati. L'unico valore consentito è 202502
nome Stringa vero Nome del mashup
computeEngineSettings ComputeEngineSettings falso Impostazioni del motore di calcolo
queryGroups queryGroup[] falso Gruppi di query
documentLocale Stringa falso Impostazioni locali del documento; deve essere BCP-47 codici di lingua
gatewayObjectId Stringa falso ID oggetto gateway
queryMetadata QueryMetadata falso Metadati delle query
Connessioni Connection[] falso Connessioni utente
fastCombine Booleano falso Indica se utilizzare o meno la combinazione rapida. True: usare la combinazione rapida. False (impostazione predefinita): non usare la combinazione rapida
allowNativeQueries Booleano falso Indica se sono consentite o meno query native. True (impostazione predefinita): consente query native. False: non consentire query native
skipAutomaticTypeAndHeaderDetection Booleano falso Indica se ignorare o meno il rilevamento automatico del tipo e dell'intestazione. True: ignorare il rilevamento. False (impostazione predefinita): non ignorare il rilevamento
parametrico Booleano falso Indica se viene utilizzata o meno la modalità parametrica. True: viene usata la modalità parametrica. False (impostazione predefinita): la modalità parametrica non viene usata

Contenuto di ComputeEngineSettings

Nome TIPO Obbligatorio Descrizione
allowFastCopy Booleano falso Indica se la copia rapida è abilitata o meno. True (impostazione predefinita): consente la copia rapida. False - Non consentire la copia rapida
maxConcurrency Numero intero falso Numero massimo di valutazioni simultanee da usare durante l'esecuzione del flusso di dati

Contenuto di QueryGroups

Nome TIPO Obbligatorio Descrizione
Id Stringa falso ID del gruppo di query
nome Stringa falso Nome del gruppo di query
descrizione Stringa falso Descrizione del gruppo di query
parentId Stringa falso ID padre del gruppo di query
ordine Numero intero falso Ordine del gruppo di query

Contenuto di QueryMetadata

Nome TIPO Obbligatorio Descrizione
queryId Stringa vero The query ID
queryName Stringa vero Nome della query
queryGroupId Stringa falso ID gruppo di query
isHidden Booleano falso Indica se la query è nascosta o meno. True: la query è nascosta. False (impostazione predefinita): la query non è nascosta
loadEnabled Booleano falso Indica se il caricamento è abilitato o meno. True (impostazione predefinita): il caricamento è abilitato. False: il caricamento non è abilitato

Contenuto della connessione

Nome TIPO Obbligatorio Descrizione
sentiero Stringa falso Percorso di connessione
gentile Stringa falso Tipo di connessione
connectionId Stringa falso ID connessione

Esempio di ContentDetails dei metadati

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

Esempio di 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

Descrive il contenuto di un payload di mapping Flusso di dati.

Nome TIPO Obbligatorio Descrizione
nome Stringa vero Nome del flusso di dati di mapping
properties Proprietà vero Proprietà del flusso di dati di mapping

Contenuto delle proprietà MDFTransform

Nome TIPO Obbligatorio Descrizione
tipo Stringa vero Tipo del flusso di dati. Il valore consentito è MappingDataFlow
typeProperties TypeProperties vero Proprietà del tipo del flusso di dati di mapping

Contenuto delle proprietà dei tipi MDFTransform

Nome TIPO Obbligatorio Descrizione
Fonti Origine[] falso Elenco di origini nel flusso di dati di mapping
sinks Sink[] falso Elenco di sink nel flusso di dati di mapping
transformations trasformazione[] falso Elenco delle trasformazioni nel flusso di dati di mapping
scriptLines String[] vero Righe di script che definiscono la logica del flusso di dati di mapping

Contenuto dell'origine MDFTransform

Nome TIPO Obbligatorio Descrizione
nome Stringa vero Nome dell'origine
externalRiferimenti ExternalReferences falso Riferimenti esterni per l'origine

Contenuto sink MDFTransform

Nome TIPO Obbligatorio Descrizione
nome Stringa vero Nome del sink
externalRiferimenti ExternalReferences falso Riferimenti esterni per il sink

Contenuto della trasformazione MDFTransform

Nome TIPO Obbligatorio Descrizione
nome Stringa vero Nome della trasformazione

Contenuto di MDFTransform ExternalReferences

Nome TIPO Obbligatorio Descrizione
connessione Stringa falso ID connessione per il riferimento esterno

Esempio di ContentDetails MDFTransform

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