Partager via

Format de code source d'intégration Git

Les éléments de Microsoft Fabric sont stockés dans un dossier. Le dossier contenant l’élément peut se trouver dans le répertoire racine ou dans un sous-répertoire. Lorsque vous connectez votre espace de travail à git, connectez-vous au dossier contenant les éléments. Chaque élément du dossier est représenté dans son propre sous-répertoire.

Nom de l’annuaire

Lorsque vous enregistrez un nouvel élément dans Git, l’intégration Git crée automatiquement un répertoire pour cet élément.

Le nom du répertoire d’élément est basé sur les règles suivantes :

  • Le modèle du nom est {display name}.{public facing type}.
  • Si nécessaire, les modifications suivantes sont apportées au nom d’affichage :
    • Les caractères non valides sont remplacés par le numéro HTML.
    • L’espace de début est remplacé par son numéro HTML.
    • L’espace de fin ou le point est remplacé par son numéro HTML.
  • Si ce nom de dossier n’est pas disponible, le nom du logicalID de l’élément (GUID) est utilisé au lieu du nom complet.

Par exemple, si vous disposez des éléments suivants dans un espace de travail (notez que les premiers et troisième éléments ont respectivement un espace de début et de fin invisible) :

Capture d’écran de la liste des éléments dans un espace de travail Fabric.

Les répertoires suivants sont créés dans le référentiel Git :

Capture d’écran des noms des répertoires Git contenant les éléments Fabric.

  • Une fois créée, l’intégration Git ne modifie jamais le nom d’un répertoire. Même si vous modifiez le nom de l’élément, le nom du répertoire reste le même.
  • Si vous modifiez manuellement le nom d’un répertoire d’éléments, veillez à prendre en compte les dépendances de l’élément. Par exemple, si vous modifiez le répertoire d’un modèle sémantique, veillez à mettre à jour le chemin d’accès du modèle sémantique dans le fichier de dépendance du rapport. N’oubliez pas que les emplacements de dépendance varient entre différentes expériences Fabric. La modification du nom du répertoire n’entraîne pas de modification entrante dans l’espace de travail.

Contenu du répertoire

Chaque répertoire d’éléments contient les fichiers de définition d’élément et les fichiers système générés automatiquement.

Fichiers de définition d'article

Le répertoire de chaque élément a des fichiers obligatoires qui définissent cet élément.

Les éléments suivants sont actuellement pris en charge dans Microsoft Fabric :

Bases de données mises en miroir

Les dossiers de base de données mis en miroir contiennent un fichier .json définissant la base de données mise en miroir.

Pour obtenir des instructions sur l’utilisation de l’intégration Git à des bases de données mises en miroir, consultez CI/CD pour les bases de données mises en miroir.

Fichiers de notebook

Les dossiers de notebook contiennent un fichier .py :

Pour obtenir des instructions sur l’utilisation de l’intégration Git avec les notebooks, consultez Contrôle de code source et déploiement de notebooks.

Fichiers de rapport paginé

Les dossiers de rapport paginé contiennent un fichier .rdl définissant le rapport paginé. RDL (Report Definition Language) est une représentation XML d’une définition de rapport paginé.

Pour plus d'informations sur le langage de définition de rapport (RDL), consultez . Pour obtenir des instructions sur l’utilisation de l’intégration Git avec les rapports paginés, consultez Intégration Git avec les rapports paginés.

Fichiers de rapports

Les dossiers de rapports contiennent les fichiers suivants :

  • definition.pbir
  • report.json

Pour plus d'informations sur les dossiers de rapports et une liste complète de leur contenu, voir Dossier de rapport de projet Power BI Desktop.

Fichiers de modèle sémantique

Les dossiers de modèle sémantique contiennent les fichiers suivants :

  • definition.pbism
  • Dossier \definition avec des fichiers TMDL

Pour plus d’informations sur les dossiers de modèle sémantique et une liste complète de leur contenu, consultez Dossier de modèle sémantique du projet Power BI Desktop.

Fichiers système générés automatiquement

En plus des fichiers de définition d’élément, chaque répertoire d’élément contient un ou deux fichiers système générés automatiquement, selon la version que vous utilisez :

  • Un répertoire version 1 contient item.metadata.json et item.config.json. Avec V1, les deux fichiers doivent se trouver dans le répertoire.
  • Un répertoire de la version 2 contient .platform. Ce fichier comprend le contenu des deux fichiers item.metadata.json et item.config.json. Si vous avez ce fichier, vous ne pouvez pas avoir les deux autres fichiers. Si vous utilisez la version 1 et que vous validez des modifications, vos fichiers système sont automatiquement mis à jour vers cette version.

Remarque

Votre répertoire doit contenir soit les fichiers item.metadata.json et item.config.json, soit le fichier .platform. Vous ne pouvez pas avoir les trois fichiers.

Fichier de plateforme

Dans la version 2, au lieu d’avoir deux fichiers sources dans chaque répertoire d’éléments, le fichier .platform combine toutes les informations dans un seul fichier ainsi qu’une propriété $schema. Si vous avez ce fichier, vous ne pouvez pas avoir les deux autres fichiers.

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

Le fichier .platform contient les attributs suivants :

  • version : numéro de version des fichiers système. Ce numéro est utilisé pour activer la rétrocompatibilité. Le numéro de version de l'élément peut être différent.
  • logicalId: (chaîne) Identificateur inter-espaces de travail généré automatiquement représentant un élément et sa représentation du contrôle de code source.
  • type : (chaîne) type de l’élément (modèle sémantique, rapport, etc.)
  • displayName : (chaîne) le nom de l’élément.
  • description : (chaîne facultative) description de l’élément.

Si vous renommez l'artefact dans l'espace de travail et que le dossier d'artefact dans Git a un suffixe « . », alors après validation, le displayName et le nom du répertoire dans Git correspondront.

Le logicalId connecte un élément dans un espace de travail avec son élément correspondant dans une branche Git. Les éléments avec les mêmes ID logiques sont supposés être identiques. Le logicalId préserve le lien même si le nom ou le répertoire change. Puisqu'une branche peut être synchronisée avec plusieurs espaces de travail, il est possible d'avoir des éléments dans différents espaces de travail avec le même logicalId, mais un seul espace de travail ne peut pas avoir deux éléments avec le même logicalId. Le logicalId est créé quand l’espace de travail est connecté à une branche Git ou qu’un nouvel élément est synchronisé. Le logicalId est nécessaire pour que l’intégration Git fonctionne correctement. Par conséquent, il est essentiel de ne pas le modifier en aucune façon.

Remarque

Lorsque vous validez des modifications sur Git dans la version 1, les fichiers du système sont automatiquement mis à jour vers la version 2 en même temps que les modifications. De même, tous les nouveaux fichiers exportés à partir du mode développeur de Power BI Desktop seront enregistrés dans le format de fichier de la version 2.

Remarque

  • Le champ type respecte la casse. Ne modifiez pas la façon dont ils sont générés automatiquement, car cela risque d’échouer.
  • Généralement, vous ne devez pas changer le logicalId ou le nom d’affichage d’un élément, mais vous pouvez faire une exception si vous créez un élément en copiant un répertoire d’élément existant. Dans ce cas, vous devez changer le logicalId et le nom d’affichage et les remplacer par une valeur unique dans le dépôt.

Contenu connexe

Démarrez avec l’intégration Git.

  • Last updated on