Definição de fluxo de dados

Este artigo fornece um detalhamento da estrutura de definição para itens de fluxo de dados.

Peças de definição

Caminho da parte de definição tipo Obrigatório Descrição
queryMetadata.json de Metadados ContentDetails (JSON) verdadeiro Descreve metadados relacionados a opções de consulta no fluxo de dados
mashup.pq Detalhes do Conteúdo do Mashup (PQ) verdadeiro Descreve o conteúdo de mashup da carga útil. Ele contém a sequência de todas as etapas executadas no fluxo de dados
<mdfTransformName>.mdf MDFTransform ContentDetails (JSON) falso Descreve o conteúdo da transformação de Mapeamento de Fluxo de Dados (MDF) da carga útil. Podem existir múltiplas transformadas MDF dentro de um fluxo de dados

Conteúdo de metadadosDetalhes

Descreve o conteúdo da carga útil

Nome Tipo Obrigatório Descrição
formatVersão Cordão verdadeiro Versão do formato de item de fluxo de dados. O único valor permitido é 202502
nome Cordão verdadeiro O nome do mashup
computeEngineSettings ComputeEngineSettings falso As configurações do mecanismo de computação
queryGroups QueryGroup [] falso Grupos de consultas
documentLocale Cordão falso A localidade do documento; precisa ser códigos de idioma BCP-47
gatewayObjectId Cordão falso A ID do objeto de gateway
consultasMetadados ConsultasMetadados falso Consulta metadados
conexões Conexão[] falso Ligações de utilizador
fastCombine booleano falso Indica se deve ou não usar combinação rápida. True - use combinação rápida. Falso (padrão) - não use combinação rápida
allowNativeQueries booleano falso Indica se consultas nativas são permitidas ou não. True (padrão) - permite consultas nativas. Falso - não permite consultas nativas
skipAutomaticTypeAndHeaderDetection booleano falso Indica se a deteção automática de tipo e cabeçalho deve ou não ser ignorada. True - ignore a deteção. Falso (padrão) - não ignore a deteção
paramétrico booleano falso Indica se o modo paramétrico é usado ou não. True - o modo paramétrico é usado. Falso (padrão) - o modo paramétrico não é usado

Conteúdo de ComputeEngineSettings

Nome Tipo Obrigatório Descrição
allowFastCopy booleano falso Indica se a cópia rápida está habilitada ou não. True (padrão) - permitir cópia rápida. Falso - Não permitir cópia rápida
maxSimultaneidade Número inteiro falso O número máximo de avaliações simultâneas a serem usadas ao executar o fluxo de dados

Conteúdo de QueryGroups

Nome Tipo Obrigatório Descrição
ID Cordão falso A ID do grupo de consulta
nome Cordão falso O nome do grupo de consulta
descrição Cordão falso A descrição do grupo de consulta
parentId Cordão falso A ID pai do grupo de consulta
Encomenda Número inteiro falso A ordem do grupo de consulta

ConsultasConteúdo de metadados

Nome Tipo Obrigatório Descrição
queryId Cordão verdadeiro O ID da consulta
queryName Cordão verdadeiro O nome da consulta
queryGroupId Cordão falso O ID do grupo de consulta
isHidden booleano falso Indica se a consulta está oculta ou não. True - a consulta está oculta. Falso (padrão) - a consulta não está oculta
loadEnabled booleano falso Indica se a carga está habilitada ou não. True (padrão) - a carga está ativada. Falso - o carregamento não está ativado

Conteúdo da conexão

Nome Tipo Obrigatório Descrição
caminho Cordão falso O caminho de conexão
tipo Cordão falso O tipo de conexão
connectionId Cordão falso O ID de conexão

Exemplo de 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
}

Exemplo de 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 ConteúdoDetalhes

Descreve o conteúdo de uma carga útil de Mapping Fluxo de Dados.

Nome Tipo Obrigatório Descrição
nome Cordão verdadeiro O nome do fluxo de dados de mapeamento
properties Propriedades verdadeiro As propriedades do fluxo de dados de mapeamento

MDFTransform Propriedades Índice

Nome Tipo Obrigatório Descrição
tipo Cordão verdadeiro O tipo de fluxo de dados. O valor permitido é MappingDataFlow
typeProperties Propriedades de Tipo verdadeiro As propriedades de tipo do fluxo de dados de mapeamento

MDFTransform TipoPropriedades Índice

Nome Tipo Obrigatório Descrição
Fontes Fonte[] falso A lista de fontes no fluxo de dados de mapeamento
sinks Lava-loiça[] falso A lista de sumidouros no fluxo de dados de mapeamento
transformations Transformação[] falso A lista de transformações no fluxo de dados de mapeamento
scriptLines Cadeia[] verdadeiro As linhas de script que definem a lógica do fluxo de dados de mapeamento

Conteúdo Fonte MDFTransform

Nome Tipo Obrigatório Descrição
nome Cordão verdadeiro O nome da fonte
externalReferências Referências Externas falso As referências externas para a fonte

Índice do sumidouro MDFTransform

Nome Tipo Obrigatório Descrição
nome Cordão verdadeiro O nome da pia
externalReferências Referências Externas falso As referências externas para o lavatório

Conteúdos da Transformação MDFTransform

Nome Tipo Obrigatório Descrição
nome Cordão verdadeiro O nome da transformação

MDFTransform ExternalReferences Conteúdos

Nome Tipo Obrigatório Descrição
ligação Cordão falso O ID de ligação para a referência externa

Exemplo MDFTransform ContentDetails

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