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