Definizione del flusso di dati

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

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
    }
  },
  "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";