En este artículo se proporciona un desglose de la estructura de definición de los elementos de flujo de datos.
Elementos de definición
| Ruta de acceso del elemento de definición |
tipo |
Obligatorio |
Descripción |
queryMetadata.json |
contenido de metadatosDetails (JSON) |
cierto |
Describe los metadatos relacionados con las opciones de consulta en el flujo de datos. |
mashup.pq |
contentDetails (PQ) |
cierto |
Describe el contenido de mashup de la carga útil. Contiene una secuencia de todos los pasos realizados en el flujo de datos. |
<mdfTransformName>.mdf |
MDFTransform ContentDetails (JSON) |
falso |
Describe asignación Data Flow (MDF) transformar el contenido de la carga. Puede haber varias transformaciones de MDF dentro de un flujo de datos. |
ContentDetails de metadatos
Describe el contenido de la carga útil.
| Nombre |
Tipo |
Obligatorio |
Descripción |
| formatVersion |
Cuerda |
cierto |
Versión del formato del elemento de flujo de datos. El único valor permitido es 202502 |
| nombre |
Cuerda |
cierto |
Nombre del mashup |
| computeEngineSettings |
computeEngineSettings |
falso |
Configuración del motor de proceso |
| queryGroups |
QueryGroup[] |
falso |
Grupos de consultas |
| documentLocale |
Cuerda |
falso |
Configuración regional del documento; debe ser códigos de idioma BCP-47 |
| gatewayObjectId |
Cuerda |
falso |
Identificador del objeto de puerta de enlace |
| queriesMetadata |
ConsultasMetadata |
falso |
Metadatos de consultas |
| Conexiones |
de conexión [] |
falso |
Conexiones de usuario |
| fastCombine |
Booleano |
falso |
Indica si se va a usar o no combinación rápida. True: use combinación rápida. False (valor predeterminado): no usar combinación rápida |
| allowNativeQueries |
Booleano |
falso |
Indica si se permiten o no consultas nativas. True (valor predeterminado): permite consultas nativas. False: no permitir consultas nativas |
| skipAutomaticTypeAndHeaderDetection |
Booleano |
falso |
Indica si se omitirá o no la detección automática de tipos y encabezados. True: omitir la detección. False (valor predeterminado): no omitir la detección |
| paramétrico |
Booleano |
falso |
Indica si se usa o no el modo paramétrico. True: se usa el modo paramétrico. False (valor predeterminado): no se usa el modo paramétrico |
Contenido de ComputeEngineSettings
| Nombre |
Tipo |
Obligatorio |
Descripción |
| allowFastCopy |
Booleano |
falso |
Indica si la copia rápida está habilitada o no. True (valor predeterminado): permite una copia rápida. False: no permitir copia rápida |
| maxConcurrency |
Entero |
falso |
Número máximo de evaluaciones simultáneas que se usarán al ejecutar el flujo de datos. |
Contenido de QueryGroups
| Nombre |
Tipo |
Obligatorio |
Descripción |
| identificación |
Cuerda |
falso |
Identificador del grupo de consultas |
| nombre |
Cuerda |
falso |
Nombre del grupo de consultas |
| descripción |
Cuerda |
falso |
Descripción del grupo de consultas |
| parentId |
Cuerda |
falso |
Identificador primario del grupo de consultas |
| orden/pedido |
Entero |
falso |
El orden del grupo de consultas |
QueriesMetadata Contents
| Nombre |
Tipo |
Obligatorio |
Descripción |
| queryId |
Cuerda |
cierto |
Identificador de consulta |
| queryName |
Cuerda |
cierto |
Nombre de la consulta |
| queryGroupId |
Cuerda |
falso |
Identificador del grupo de consultas |
| isHidden |
Booleano |
falso |
Indica si la consulta está oculta o no. True: la consulta está oculta. False (valor predeterminado): la consulta no está oculta |
| loadEnabled |
Booleano |
falso |
Indica si la carga está habilitada o no. True (valor predeterminado): la carga está habilitada. False: la carga no está habilitada |
Contenido de la conexión
| Nombre |
Tipo |
Obligatorio |
Descripción |
| camino |
Cuerda |
falso |
Ruta de acceso de conexión |
| amable |
Cuerda |
falso |
Tipo de conexión |
| connectionId |
Cuerda |
falso |
El identificador de conexión |
Ejemplo de ContentDetails de metadatos
{
"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
}
Ejemplo 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 ContentDetails
Describe el contenido de una carga de Data Flow de asignación.
| Nombre |
Tipo |
Obligatorio |
Descripción |
| nombre |
Cuerda |
cierto |
Nombre del flujo de datos de asignación |
| properties |
Propiedades |
cierto |
Propiedades del flujo de datos de asignación |
Contenido de las propiedades de MDFTransform
| Nombre |
Tipo |
Obligatorio |
Descripción |
| tipo |
Cuerda |
cierto |
Tipo del flujo de datos. El valor permitido es MappingDataFlow |
| typeProperties |
TypeProperties |
cierto |
Propiedades de tipo del flujo de datos de asignación |
Contenido de TypeProperties de MDFTransform
| Nombre |
Tipo |
Obligatorio |
Descripción |
| Fuentes |
Origen[] |
falso |
Lista de orígenes en el flujo de datos de asignación |
| sinks |
Sink[] |
falso |
Lista de receptores en el flujo de datos de asignación |
| transformations |
de transformación [] |
falso |
Lista de transformaciones en el flujo de datos de asignación |
| scriptLines |
Cadena[] |
cierto |
Líneas de script que definen la lógica del flujo de datos de asignación |
Contenido del origen de MDFTransform
| Nombre |
Tipo |
Obligatorio |
Descripción |
| nombre |
Cuerda |
cierto |
Nombre del origen |
| externalReferences |
ExternalReferences |
falso |
Referencias externas para el origen |
Contenido del receptor de MDFTransform
| Nombre |
Tipo |
Obligatorio |
Descripción |
| nombre |
Cuerda |
cierto |
Nombre del receptor |
| externalReferences |
ExternalReferences |
falso |
Referencias externas para el receptor |
Contenido de transformación MDFTransform
| Nombre |
Tipo |
Obligatorio |
Descripción |
| nombre |
Cuerda |
cierto |
Nombre de la transformación |
Contenido de ExternalReferences de MDFTransform
| Nombre |
Tipo |
Obligatorio |
Descripción |
| connection |
Cuerda |
falso |
Identificador de conexión de la referencia externa |
Ejemplo 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"
]
}
}
}