Démarrer avec l’intégration Git

Cet article vous guide tout au long des tâches de base suivantes dans l’outil d’intégration Git de Microsoft Fabric :

• Se connecter à un référentiel Git
• Valider les modifications
• Mettre à jour à partir de Git
• Se déconnecter de Git

Il est recommandé de lire la vue d’ensemble de l’intégration Git avant de commencer.

Prérequis

Pour intégrer Git à votre espace de travail Microsoft Fabric, vous devez configurer les prérequis suivants dans Fabric et Git.

Prérequis Fabric

Pour accéder à la fonctionnalité d’intégration Git, vous avez besoin de l’une des options suivante  :

• Une licence Power BI Premium. Une licence Power BI Premium prend uniquement en charge tous les éléments Power BI.
• Une capacité Fabric. Une capacité Fabric est nécessaire pour utiliser tous les éléments Fabric pris en charge. Si vous n’en avez pas encore, inscrivez-vous à un essai gratuit.

De plus, les commutateurs de client suivants doivent être activés à partir du portail d’administration :

• Les utilisateurs peuvent créer des éléments Fabric
• Les utilisateurs peuvent synchroniser des éléments d’espace de travail avec leurs référentiels Git
• Pour les utilisateurs GitHub uniquement : les utilisateurs peuvent synchroniser des éléments d’espace de travail avec des référentiels GitHub

Ces commutateurs peuvent être activés par l’administrateur client, l’administrateur de capacité ou l’administrateur de l’espace de travail, en fonction des paramètres de votre organisation.

Conditions préalables pour Git

L’intégration Git est actuellement prise en charge pour Azure DevOps et GitHub. Pour utiliser l’intégration Git à votre espace de travail Fabric, vous avez besoin des éléments suivants dans Azure DevOps ou GitHub :

Limitations d’Azure DevOps

• Un compte Azure actif inscrit auprès du même utilisateur qui utilise l’espace de travail Fabric. Créer un compte gratuit.
• Accès à un référentiel existant.

Limitations de GitHub

• Un compte GitHub actif. Créer un compte GitHub.

• Un des jetons d’accès personnels suivants :

  • Un jeton affiné (recommandé) avec l’autorisation de lecture et d’écriture de contenus sous les autorisations de référentiel :

    

    Pour utiliser ce jeton avec GitHub Enterprise, suivez ces instructions.

  • Une action Créer un jeton classique GitHub avec des étendues de référentiel activée :

    

Connecter un espace de travail dans un référentiel Git

Se connecter à un référentiel Git

Seul un administrateur d’espace de travail peut connecter un espace de travail à un référentiel mais, une fois connecté, toute personne disposant d’une autorisation peut travailler dans l’espace de travail. Si vous n’êtes pas administrateur, demandez de l’aide à votre administrateur pour vous connecter. Pour connecter un espace de travail à un référentiel Azure ou GitHub, procédez comme suit :

1. Connectez-vous à Fabric et accédez à l’espace de travail avec lequel vous souhaitez vous connecter.

2. Accédez à Paramètres de l’espace de travail

   

3. Configurer l’intégration de Git.

4. Sélectionnez votre fournisseur Git. Actuellement, Azure DevOps et GitHub sont pris en charge.

Connexion à Azure DevOps

Si vous sélectionnez Azure DevOps, sélectionnez Connexion pour vous connecter automatiquement au compte Azure Repos inscrit auprès de l’utilisateur Microsoft Entra connecté à Fabric.

GitHub Connect

Si vous sélectionnez GitHub, vous devez vous connecter à votre compte GitHub.
Sélectionnez Ajouter un compte s’il s’agit de votre première connexion à partir de Fabric, ou sélectionnez l’un des comptes répertoriés. Une fois connecté, sélectionnez Se connecter pour autoriser Fabric à accéder à votre compte GitHub.

S’il s’agit de la première connexion, vous devez autoriser votre utilisateur GitHub. Renseignez les informations suivantes :

• Nom complet : doit être unique pour chaque utilisateur GitHub
• Jeton d’accès personnel -  : votre jeton d’accès personnel classique ou affiné
• URL du référentiel (facultatif) : si vous n’entrez pas d’URL, vous pouvez vous connecter à n’importe quel référentiel auquel vous avez accès. Si vous entrez une URL, vous ne pouvez vous connecter qu’à ce référentiel.

Se connecter à un espace de travail

Si l’espace de travail est déjà connecté à GitHub, suivez les instructions de Connexion à un espace de travail partagé.

Connexion de branche Azure DevOps

1. Dans le menu déroulant, spécifiez les détails suivants sur la branche à laquelle vous souhaitez vous connecter :

   Remarque

   Vous ne pouvez connecter un espace de travail qu’à une seule branche et un seul dossier à la fois.

   • Organisation
   • Projet
   • Référentiel Git.
   • Branche (Sélectionnez une branche existante à l’aide du menu déroulant ou sélectionnez + Nouvelle branche pour créer une nouvelle branche. Vous ne pouvez vous connecter qu’à une seule branche à la fois.)
   • Dossier (entrez le nom d’un dossier existant ou entrez un nom pour créer un nouveau dossier. Si vous laissez le nom de dossier vide, le contenu sera créé dans le dossier racine. Vous ne pouvez vous connecter qu’à un seul dossier à la fois.)

Connexion de branche GitHub

1. Dans le menu déroulant, spécifiez les détails suivants sur la branche à laquelle vous souhaitez vous connecter :

   Remarque

   Vous ne pouvez connecter un espace de travail qu’à une seule branche et un seul dossier à la fois.

   • URL du dépôt. Si vous vous êtes connecté à GitHub à l’aide d’un jeton limité, l’URL est automatiquement renseignée et vous pouvez uniquement vous connecter à ce référentiel.
   • Branche (Sélectionnez une branche existante à l’aide du menu déroulant ou sélectionnez + Nouvelle branche pour créer une nouvelle branche. Vous ne pouvez vous connecter qu’à une seule branche à la fois.)
   • Dossier (entrez le nom d’un dossier existant ou entrez un nom pour créer un nouveau dossier. Si vous laissez le nom de dossier vide, le contenu sera créé dans le dossier racine. Vous ne pouvez vous connecter qu’à un seul dossier à la fois.)

Sélectionnez Se connecter et synchroniser.

Pendant la synchronisation initiale, si l’espace de travail ou la branche Git est vide, le contenu est copié de l’emplacement non vide vers l’emplacement vide. Si l’espace de travail et la branche Git ont du contenu, vous devez choisir la direction à suivre pour la synchronisation. Pour plus d’informations sur cette synchronisation initiale, consultez Se connecter et synchroniser.

Une fois connecté, l’espace de travail affiche des informations sur le contrôle de code source qui permettent à l’utilisateur d’afficher la branche connectée, l’état de chaque élément de la branche et l’heure de la dernière synchronisation.

Pour maintenir la synchronisation de votre espace de travail avec la branche Git, validez toutes les modifications que vous apportez dans l’espace de travail dans la branche Git et mettez à jour votre espace de travail chaque fois que quelqu’un crée de nouvelles validations dans la branche Git.

Valider les modifications apportées à Git

Une fois que vous êtes connecté à un dossier Git, modifiez votre espace de travail comme d’habitude. Toutes les modifications que vous enregistrez sont enregistrées dans l’espace de travail uniquement. Lorsque vous êtes prêt, vous pouvez valider vos modifications dans la branche Git, ou vous pouvez annuler les modifications et revenir à l’état précédent. En savoir plus sur les validations.

Validation sur git

Pour valider vos modifications dans la branche Git, procédez comme suit :

1. Accéder à l’espace de travail.

2. Sélectionnez l’icône Contrôle de code source. Cette icône affiche le nombre de modifications non validées.

3. Sélectionnez Modifications dans le volet Contrôle de code source. Une liste apparaît avec tous les éléments que vous avez modifiés, ainsi qu'une icône indiquant si l'élément est nouveau, modifié, conflictuel ou supprimé.

4. Sélectionnez les éléments que vous voulez valider. Pour sélectionner tous les éléments, cochez la case du haut.

5. Ajoutez un commentaire dans la case. Si vous n’ajoutez pas de commentaire, un message par défaut est ajouté automatiquement.

6. Sélectionner Valider.

   

Une fois les modifications validées, les éléments qui ont été validés sont supprimés de la liste et l’espace de travail pointe vers la nouvelle validation avec laquelle il est synchronisé.

Une fois la validation terminée, l’état des éléments sélectionnés passe de Non validé à Synchronisé.

Annuler la modification enregistrée

Après avoir enregistré les modifications apportées à l’espace de travail, si vous décidez de ne pas commiter ces modifications sur Git, vous pouvez annuler les modifications et rétablir ces éléments à l’état précédent. Pour annuler vos modifications, procédez comme suit :

1. Accéder à l’espace de travail.

2. Sélectionnez le bouton Contrôle de code source. Ce bouton affiche également le nombre de modifications non validées.

3. Sélectionnez Modifications du volet Contrôle de code source. Une liste s’affiche avec tous les éléments que vous avez modifiés et une icône indique si l’élément modifié est nouveau, modifié, conflictuel, ou supprimé.

4. Sélectionnez les modifications que vous souhaitez annuler.

5. Sélectionnez Annuler.

   

6. Sélectionnez Annuler à nouveau pour confirmer.

   

Les éléments sélectionnés dans votre espace de travail retournent à l’état dans lequel ils étaient lors de la dernière synchronisation de l’espace de travail.

Important

Si vous supprimez un élément, puis annulez les modifications, l’élément est à nouveau créé et certaines métadonnées peuvent être perdues. Par exemple, les étiquettes de confidentialité ne sont pas conservées et doivent être réinitialisées, et le propriétaire de l’élément est défini sur l’utilisateur actuel.

Mettre à jour l’espace de travail à partir de Git

Chaque fois que quelqu’un valide une nouvelle modification de la branche Git connectée, une notification s’affiche dans l’espace de travail approprié. Utilisez le volet Contrôle de code source pour intégrer les dernières modifications, fusions ou restaurations dans l’espace de travail et mettre à jour les éléments en direct. En savoir plus sur la mise à jour.

Pour mettre à jour un espace de travail, procédez comme suit :

1. Accéder à l’espace de travail.
2. Sélectionnez l’icône Contrôle de code source.
3. Sélectionnez Mises à jour du volet Contrôle de code source. Une liste s’affiche avec tous les éléments qui ont été modifiés dans la branche depuis la dernière mise à jour.
4. Sélectionnez Tout mettre à jour.

Une fois la mise à jour réussie, la liste des éléments est supprimée et l’espace de travail pointe vers la nouvelle validation avec laquelle il est synchronisé.

Une fois la mise à jour terminée, l’état des éléments devient Synchronisé.

Déconnecter un espace de travail de Git

Seul un administrateur d’espace de travail peut déconnecter un espace de travail d’un référentiel Git. Si vous n’êtes pas administrateur, demandez de l’aide à votre administrateur pour vous déconnecter. Si vous êtes administrateur et que vous souhaitez déconnecter votre référentiel, procédez comme suit :

1. Accédez à Paramètres de l’espace de travail
2. Configurez l’intégration de Git
3. Sélectionnez Déconnecter l’espace de travail
4. Sélectionnez à nouveau Déconnecter pour confirmer.

autorisations

Les actions que vous pouvez effectuer sur un espace de travail dépendent des autorisations dont vous disposez à la fois dans l’espace de travail et dans le référentiel Git. Pour une présentation plus détaillée des autorisations, consultez Autorisations.

Observations et limitations

Limitations générales de l’intégration Git

• La méthode d’authentification dans Fabric doit être au moins aussi forte que la méthode d’authentification pour Git. Par exemple, si Git nécessite une authentification multifacteur, Fabric doit également exiger l’authentification multifacteur.
• Les jeux de données Power BI connectés à Analysis Services ne sont pas pris en charge pour l’instant.
• Les espaces de travail avec des applications modèles installées ne peuvent pas être connectés à Git.
• Les sous-modules ne sont pas pris en charge.
• Les clouds souverains ne sont pas pris en charge.

Limitations d’Azure DevOps

• Le compte Azure DevOps doit être inscrit auprès du même utilisateur qui utilise l’espace de travail Fabric.
• L’admin client doit activer les exportations intergéographiques si l’espace de travail et le référentiel Git se trouvent dans deux régions géographiques différentes.
• Si votre organisation configure l’accès conditionnel, vérifiez que le service Power BI a les mêmes conditions définies pour que l’authentification fonctionne comme prévu.
• La taille d’un commit est limitée à 125 Mo.

Limitations de GitHub

• GitHub ne peut pas appliquer de validations intergéographiques.
• La taille combinée totale des fichiers à valider en une fois est limitée à 50 Mo. Par conséquent, si vous avez plusieurs éléments à valider, il peut parfois être nécessaire de les séparer en quelques validations distinctes. Pour plus d’informations sur la validation de fichiers, consultez notre guide de résolution des problèmes.

Limites GitHub Enterprise

Certains paramètres GitHub Enterprise ne sont pas pris en charge. Par exemple :

• Liste verte d’adresses IP
• Réseau privé
• Domaines personnalisés

Limitations de l’espace de travail

• Seul l’administrateur de l’espace de travail peut gérer les connexions au référentiel Git, telles que la connexion, la déconnexion ou l’ajout d’une branche.
  Une fois connecté, toute personne autorisée peut travailler dans l’espace de travail.
• La structure de dossiers de l’espace de travail n’est pas reflétée dans le référentiel Git. Les éléments de l’espace de travail dans les dossiers sont exportés vers le répertoire racine.

Limitations des branches et des dossiers

• La longueur maximale du nom de la branche est de 244 caractères.
• La longueur maximale du chemin d’accès complet pour les noms de fichiers est de 250 caractères. Les noms plus longs échouent.
• La taille maximale du fichier est de 25 Mo.
• Vous ne pouvez pas télécharger un rapport/jeu de données en tant que .pbix à partir du service après leur déploiement avec Intégration Git.
• Le dossier Git utilise l’ID logique (Guid) comme préfixe avant le type si le nom d’affichage de l’élément :
  • Comporte plus de 256 caractères
  • Se termine par . ou un espace
  • Contient l’un des caractères suivants : "/:<>\*?|

Limitations du nom de répertoire

• Le nom du répertoire qui se connecte au référentiel Git a les restrictions d’affectation de noms suivantes :

  • Le nom du répertoire ne peut pas commencer ou se terminer par un espace ou un onglet.
  • Le nom du répertoire ne peut contenir aucun des caractères suivants : "/:<>\*?|

• Le dossier d’éléments (le dossier qui contient les fichiers d’éléments) ne peut contenir aucun des caractères suivants : «:<>\*?|. Si vous renommez le dossier en un de ces caractères, Git ne peut pas se connecter ou se synchroniser avec l’espace de travail et une erreur se produit.

Limitations de branchement

• Le branchement nécessite des autorisations répertoriées dans la table d’autorisations.
• Il doit y avoir une capacité disponible pour cette action.
• Toutes les limitations d’affectation de noms d’espace de travail et de branche s’appliquent lors du branchement à un nouvel espace de travail.
• Lors de l’extraction de branche, un nouvel espace de travail est créé et les paramètres de l’espace de travail d’origine ne sont pas copiés. Ajustez les paramètres ou définitions pour vous assurer que le nouvel espace de travail répond aux stratégies de votre organisation.
• Seuls les éléments pris en charge par Git sont disponibles dans le nouvel espace de travail.
• La liste des branches associées affiche uniquement les branches et les espaces de travail que vous avez l’autorisation d’afficher.
• L’intégration Git doit être activée.

Limitations de synchronisation et de validation

• Vous ne pouvez synchroniser que dans une seule direction à la fois. Vous ne pouvez pas valider et mettre à jour en même temps.
• Les étiquettes de confidentialité ne sont pas prises en charge et l’exportation d’éléments avec des étiquettes de confidentialité peut être désactivée. Pour valider les éléments qui ont des étiquettes de confidentialité sans étiquette de confidentialité, demandez de l’aide à votre administrateur.
• Fonctionne avec des éléments limités. Des éléments non pris en charge dans le dossier sont ignorés.
• La duplication des noms n’est pas autorisée. Même si Power BI autorise la duplication de noms, l’action de mise à jour, de validation ou d’annulation échoue.
• B2B n’est pas pris en charge.
• La résolution des conflits est partiellement effectuée dans Git.
• Pendant le processus de Validation vers Git, le service Fabric supprime tous les fichiers à l’intérieur du dossier d’élément qui ne font pas partie de la définition d’élément. Les fichiers non liés qui ne se trouvent pas dans un dossier d’élément ne sont pas supprimés.
• Une fois les modifications validées, il est possible que vous remarquiez des modifications inattendues et que vous n’avez pas effectuées apportées à l’élément. Ces modifications sont sémantiquement insignifiantes et peuvent se produire pour plusieurs raisons. Par exemple :
  • Modification manuelle du fichier de définition d’élément. Ces modifications sont valides, mais peuvent être différentes de celles effectuées par le biais des éditeurs. Par exemple, si vous renommez une colonne de modèle sémantique dans Git et que vous importez ce changement dans l’espace de travail, la prochaine fois que vous validerez les changements apportés au modèle sémantique, le fichier bim sera inscrit comme modifié et la colonne modifiée sera envoyée à l’arrière du groupe columns. Cela est dû au fait que le moteur AS qui génère les fichiers bim envoie (push) les colonnes renommées à la fin du tableau. Cette modification n’affecte pas le fonctionnement de l’élément.
  • Validation d’un fichier qui utilise des sauts de ligne CRLF. Le service utilise des sauts de ligne LF. Si vous aviez des fichiers d’élément dans le référentiel Git avec des sauts de ligne CRLF, lorsque vous validez à partir du service, ces fichiers sont modifiés en LF. Par exemple, si vous ouvrez un rapport dans le bureau, enregistrez le projet .pbip et chargez-le sur Git avec CRLF.
• L’actualisation d’un modèle sémantique en utilisant l’API Actualisation améliorée provoque une différence Git après chaque actualisation.

Contenu connexe

• Comprendre le processus d’intégration Git
• Gérer les branches GIT
• Meilleures pratiques pour l’intégration Git