Partager via


Définition du flux de données

Cet article fournit une répartition de la structure de définition pour les éléments de flux de données.

Parties de définition

Chemin d’accès du composant Définition type Obligatoire Descriptif
queryMetadata.json ContentDetails de métadonnées (JSON) vrai Décrit les métadonnées liées aux options de requête dans le flux de données
mashup.pq Mashup ContentDetails (PQ) vrai Décrit le contenu mashup de la charge utile. Il contient la séquence de toutes les étapes effectuées dans le flux de données

ContentDetails de métadonnées

Décrit le contenu de la charge utile

Nom Catégorie Obligatoire Descriptif
formatVersion Chaîne vrai Version du format d’élément de flux de données. La seule valeur autorisée est 202502
nom Chaîne vrai Nom du mashup
computeEngineSettings ComputeEngineSettings faux Paramètres du moteur de calcul
queryGroups QueryGroup[] faux Groupes de requêtes
documentLocale Chaîne faux Paramètres régionaux du document ; doit être des codes de langue BCP-47
gatewayObjectId Chaîne faux ID d’objet de passerelle
queriesMetadata QueriesMetadata faux Métadonnées de requêtes
Connexions connexion[] faux Connexions utilisateur
fastCombine Booléen faux Indique si vous souhaitez utiliser la combinaison rapide ou non. True : utilisez la combinaison rapide. False (valeur par défaut) : n’utilisez pas la combinaison rapide
allowNativeQueries Booléen faux Indique si les requêtes natives sont autorisées ou non. True (valeur par défaut) : autorisez les requêtes natives. False : n’autorisez pas les requêtes natives
skipAutomaticTypeAndHeaderDetection Booléen faux Indique s’il faut ignorer ou non la détection automatique du type et de l’en-tête. True : ignorer la détection. False (valeur par défaut) : ne pas ignorer la détection
paramétrique Booléen faux Indique si le mode paramétrique est utilisé ou non. True : le mode paramétrique est utilisé. False (valeur par défaut) : le mode paramétrique n’est pas utilisé

Contenu ComputeEngineSettings

Nom Catégorie Obligatoire Descriptif
allowFastCopy Booléen faux Indique si la copie rapide est activée ou non. True (valeur par défaut) : autorisez la copie rapide. False - Ne pas autoriser la copie rapide
maxConcurrency Nombre entier faux Nombre maximal d’évaluations simultanées à utiliser lors de l’exécution du flux de données

Contenu de QueryGroups

Nom Catégorie Obligatoire Descriptif
pièce d'identité Chaîne faux ID du groupe de requêtes
nom Chaîne faux Nom du groupe de requêtes
description Chaîne faux Description du groupe de requêtes
parentId Chaîne faux ID parent du groupe de requêtes
commande Nombre entier faux Ordre du groupe de requêtes

Contenu de QueriesMetadata

Nom Catégorie Obligatoire Descriptif
queryId Chaîne vrai ID de requête
queryName Chaîne vrai Nom de la requête
queryGroupId Chaîne faux ID du groupe de requêtes
isHidden Booléen faux Indique si la requête est masquée ou non. True : la requête est masquée. False (valeur par défaut) : la requête n’est pas masquée
loadEnabled Booléen faux Indique si la charge est activée ou non. True (valeur par défaut) : la charge est activée. False : la charge n’est pas activée

Contenu de la connexion

Nom Catégorie Obligatoire Descriptif
chemin Chaîne faux Chemin d’accès de connexion
gentil Chaîne faux Type de connexion
connectionId Chaîne faux ID de connexion

Exemple ContentDetails de métadonnées

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

Exemple 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";