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