Definição de fluxo de dados

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

Partes de definição

Caminho da parte de definição tipo Obrigatório Descrição
queryMetadata.json contentDetails de metadados (JSON) verdadeiro Descreve metadados relacionados às opções de consulta no fluxo de dados
mashup.pq Mashup ContentDetails (PQ) verdadeiro Descreve o conteúdo do mashup de conteúdo. Ele contém a sequência de todas as etapas executadas no fluxo de dados
<mdfTransformName>.mdf JSON (MDFTransform ContentDetails ) falso Descreve o conteúdo de transformação de MDF (Fluxo de Dados de Mapeamento) do conteúdo do conteúdo. Pode haver várias transformações de MDF em um fluxo de dados

ContentDetails de metadados

Descreve o conteúdo do conteúdo

Nome Tipo Obrigatório Descrição
formatVersion fio verdadeiro Versão do formato de item de fluxo de dados. O único valor permitido é 202502
nome fio verdadeiro O nome do mashup
computeEngineSettings computeEngineSettings falso As configurações do mecanismo de computação
queryGroups QueryGroup[] falso Grupos de consultas
documentLocale fio falso A localidade do documento; precisa ser códigos de linguagem BCP-47
gatewayObjectId fio falso A ID do objeto do gateway
queriesMetadata QueriesMetadata falso Metadados de consultas
Conexões de Conexão [] falso Conexões de usuário
fastCombine booleano falso Indica se deve ou não usar combinação rápida. True – use combinação rápida. False (padrão) – não use combinação rápida
allowNativeQueries booleano falso Indica se as consultas nativas são permitidas ou não. True (padrão) – permitir consultas nativas. False – não permitir consultas nativas
skipAutomaticTypeAndHeaderDetection booleano falso Indica se o tipo automático e a detecção de cabeçalho devem ou não ser ignoradas. True – ignorar a detecção. False (padrão) – não ignore a detecção
paramétrico booleano falso Indica se o modo paramétrico é usado ou não. True – o modo paramétrico é usado. False (padrão) – o modo paramétrico não é usado

Conteúdo 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. False – Não permitir cópia rápida
maxConcurrency 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 fio falso A ID do grupo de consultas
nome fio falso O nome do grupo de consultas
descrição fio falso A descrição do grupo de consultas
parentId fio falso A ID pai do grupo de consultas
ordem Número Inteiro falso A ordem do grupo de consultas

Conteúdo de QueriesMetadata

Nome Tipo Obrigatório Descrição
queryId fio verdadeiro A ID da consulta
queryName fio verdadeiro O nome da consulta
queryGroupId fio falso A ID do grupo de consultas
IsHidden booleano falso Indica se a consulta está oculta ou não. True – a consulta está oculta. False (padrão) – a consulta não está oculta
loadEnabled booleano falso Indica se o carregamento está habilitado ou não. True (padrão) – a carga está habilitada. False – a carga não está habilitada

Conteúdo da Conexão

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

Exemplo de ContentDetails de metadados

{
  "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 ContentDetails do Mashup

[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

Descreve o conteúdo de uma carga de Fluxo de Dados de mapeamento.

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

Conteúdo de propriedades MDFTransform

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

Conteúdo TypeProperties MDFTransform

Nome Tipo Obrigatório Descrição
Fontes Origem[] falso A lista de fontes no fluxo de dados de mapeamento
sinks Coletor[] falso A lista de coletores no fluxo de dados de mapeamento
transformations de Transformação [] falso A lista de transformações no fluxo de dados de mapeamento
scriptLines String[] verdadeiro As linhas de script que definem a lógica de fluxo de dados de mapeamento

Conteúdo de origem MDFTransform

Nome Tipo Obrigatório Descrição
nome fio verdadeiro O nome da origem
referências externas ExternalReferences falso As referências externas para a origem

Conteúdo do coletor MDFTransform

Nome Tipo Obrigatório Descrição
nome fio verdadeiro O nome do coletor
referências externas ExternalReferences falso As referências externas para o coletor

Conteúdo da transformação MDFTransform

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

Conteúdo de ExternalReferences de MDFTransform

Nome Tipo Obrigatório Descrição
conexão fio falso A ID da conexão para a referência externa

Exemplo de ContentDetails de 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"
      ]
    }
  }
}