Concepts de base de l’intégration Git

Cet article explique les concepts Git de base et le processus d’intégration de Git à votre espace de travail Microsoft Fabric.

Important

Cette fonctionnalité est en préversion.

Autorisations

• Pour utiliser l’intégration Git, elle doit être activée par l’administrateur de votre organisation.
• Si l’espace de travail et le référentiel se trouvent dans deux régions différentes, l’exportation intergéographique doit être activée par l’administrateur du tenant (locataire). Pour plus d’informations, consultez Les utilisateurs peuvent exporter des éléments vers des référentiels Git dans d’autres emplacements géographiques.
• 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 Azure DevOps.

Autorisations Azure DevOps

La liste suivante montre ce que les différents rôles d’espace de travail peuvent faire en fonction de leurs autorisations Azure DevOps :

• Administration : peut effectuer n’importe quelle opération sur l’espace de travail, limitée uniquement par leur rôle Azure DevOps.
• Membre/Contributeur : une fois connecté à un espace de travail, un membre/contributeur peut valider et mettre à jour les modifications, en fonction de son rôle Azure DevOps. Pour les actions liées à la connexion à l’espace de travail (par exemple, se connecter, déconnecter ou changer de branche), demandez de l’aide à un Administrateur.
• Viewer : impossible d’effectuer des actions. Le viewer ne peut voir aucune information liée à Git dans l’espace de travail.

Autorisations nécessaires pour les opérations courantes

Le tableau suivant décrit les autorisations nécessaires pour effectuer diverses opérations courantes :

Opération	Rôle d’espace de travail	Autorisations Git
Connecter l’espace de travail au dépôt Git	Admin	Read=Allow
Synchroniser l’espace de travail avec le dépôt Git	Admin	Read=Allow
Déconnecter l’espace de travail du dépôt Git	Admin	Aucune autorisation n’est nécessaire
Changer de branche dans l’espace de travail (ou toute modification du paramètre de connexion)	Admin	Read=Allow (dans le dépôt/répertoire/branche cible)
Afficher les détails de la connexion Git	Administration, Membre, Contributeur	Lecture ou Aucun
Consultez l’espace de travail « état Git »	Administration, Membre, Contributeur	Read=Allow
Mettre à jour à partir de Git	Toutes les opérations suivantes : Contributeur dans l’espace de travail (autorisation WRITE sur tous les éléments) Propriétaire de l’élément (si le commutateur de locataire bloque les mises à jour pour les non-propriétaires) BUILD sur les dépendances externes (le cas échéant)	Read=Allow
Valider les modifications de l’espace de travail sur Git	Toutes les opérations suivantes : Contributeur dans l’espace de travail (autorisation WRITE sur tous les éléments) Propriétaire de l’élément (si le commutateur de locataire bloque les mises à jour pour les non-propriétaires) BUILD sur les dépendances externes (le cas échéant)	Read=Allow Contribute=Allow La stratégie de branche doit autoriser la validation directe
Créer une branche Git à partir de Fabric	Admin	Role=Write Create branch=Allow

Connexion et synchronisation

Seul un administrateur d’espace de travail peut connecter un espace de travail à Azure Repos, mais une fois connecté, toute personne disposant d’autorisations peut travailler dans l’espace de travail. Si vous n’êtes pas administrateur, demandez de l’aide à votre administrateur pour vous connecter.

Lorsque vous connectez un espace de travail à Git, Fabric se synchronise entre les deux emplacements afin qu’ils aient le même contenu. Pendant cette synchronisation initiale, si l’espace de travail ou la branche Git est vide alors que l’autre a du contenu, le contenu est copié de l’emplacement vide vers l’emplacement vide. Si l’espace de travail et la branche Git ont du contenu, vous devez décider de la direction à suivre pour la synchronisation.

• Si vous validez votre espace de travail dans la branche Git, tout le contenu de l’espace de travail pris en charge est exporté vers Git et remplace le contenu Git actuel.
• Si vous mettez à jour l’espace de travail avec le contenu git, le contenu de l’espace de travail est remplacé et vous perdez le contenu de votre espace de travail. Étant donné qu’une branche Git peut toujours être restaurée à une étape précédente alors qu’un espace de travail ne le peut pas, si vous choisissez cette option, vous êtes invité à confirmer.

Si vous ne sélectionnez pas le contenu à synchroniser, vous ne pouvez pas continuer à travailler tant que vous ne le faites pas :

État de Git

Une fois connecté, l’espace de travail affiche une colonne État Git qui indique l’état de synchronisation de chaque élément de l’espace de travail par rapport aux éléments de la branche distante.

Chaque élément a l’un des états suivants :

• Synchronisé (l'élément est le même dans l'espace de travail et la branche Git)
• Conflit (l’élément a été modifié à la fois dans l’espace de travail et la branche Git)
• Élément non pris en charge
• Modifications non validées dans l’espace de travail
• Mise à jour requise à partir de Git
• L’élément est identique aux deux emplacements, mais doit être mis à jour vers la dernière validation

Informations de synchronisation

Tant que vous êtes connecté, les informations suivantes s’affichent en bas de votre écran :

• Branche connectée
• Heure de la dernière synchronisation
• Lien vers la dernière validation avec laquelle l’espace de travail est synchronisé

Validations et mises à jour

Volet Contrôle de code source

En haut de l’écran se trouve l’icône Contrôle de code source. Il indique le nombre d’éléments différents dans l’espace de travail et la branche Git. Lorsque l’espace de travail est synchronisé avec la branche Git, l’icône contrôle de code source affiche un 0.

Lorsque des modifications sont apportées à l’espace de travail ou à la branche Git, l’icône de contrôle de code source affiche le nombre d’éléments différents. Sélectionnez l’icône de contrôle de code source pour ouvrir le volet Contrôle de code source.

Dans le volet Contrôle de source, l’onglet Modifications indique le nombre d’éléments qui ont été modifiés dans l’espace de travail et qui doivent être validées sur Git, et l’onglet Mises à jour indique le nombre d’éléments qui ont été modifiés dans la branche Git et qui doivent être mis à jour vers l’espace de travail.

Dans chaque onglet, les éléments modifiés sont répertoriés avec une icône indiquant l’état :

• nouveau
• modifié
• supprimé
• conflit

Validation

• Lorsqu’il y a plusieurs éléments à valider, vous pouvez sélectionner les éléments à valider sur la branche Git.
• Si des mises à jour ont été apportées à la branche Git, les validations sont désactivées jusqu’à ce que vous mettiez à jour votre espace de travail.

Mettre à jour

• Contrairement à la validation et à l’annulation, la commande Mise à jour met toujours à jour l’ensemble de la branche et se synchronise avec la validation la plus récente. Vous ne pouvez pas sélectionner des éléments spécifiques à mettre à jour.
• Si des modifications ont été apportées dans l’espace de travail et dans la branche Git sur le même élément, les mises à jour sont désactivées jusqu’à ce que le conflit soit résolu.

En savoir plus sur la validation et la mise à jour. En savoir plus sur le processus de mise à jour et sur la résolution des conflits.

Considérations et limitations

Limitations générales

• Le compte Azure DevOps doit être inscrit auprès du même utilisateur qui utilise l’espace de travail Fabric.
• La méthode d’authentification dans Power BI doit être au moins aussi forte que la méthode d’authentification pour Azure DevOps. Par exemple, si Azure DevOps nécessite une authentification multifacteur, Power BI doit également exiger l’authentification multifacteur.
• Les modèles Direct Query et composites sur les jeux de données Power BI et Analysis Services ne sont pas pris en charge pour l’instant.
• Les modèles sémantiques DirectLake ne sont pas pris en charge pour le moment.
• 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.

Limitations de l’espace de travail

Seul l’administrateur de l’espace de travail peut gérer les connexions au référentiel Azure, 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.

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.

• 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 : ", /, :, <, >, \\, *, ?, |

  L’ID logique (GUID) est ajouté en tant que préfixe avant le type, lors du nommage du dossier dans Git.

Limitations de synchronisation et de validation

• La limite de taille d’un commit est de 125 Mo.
• 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. Si des éléments non pris en charge se trouvent dans le dossier, ils sont ignorés.
• La duplication de noms n’est pas autorisée. Même si Power BI l’autorise, 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.

Contenu connexe

• Gérer les branches
• Résoudre les erreurs et les conflits