Concepts de base dans 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
Microsoft Fabric est en préversion.
Autorisations
Pour utiliser l’intégration git, elle doit être activée par l’administrateur de votre organization.
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 de l’espace de travail (par exemple, se connecter, déconnecter ou changer de branche), demandez de l’aide à partir d’un Administration.
- Visionneuse : impossible d’effectuer des actions. La visionneuse 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 référentiel Git | Admin | Read=Allow |
| Synchroniser l’espace de travail avec le référentiel Git | Admin | Read=Allow |
| Déconnecter l’espace de travail du référentiel Git | Admin | Aucune autorisation n’est nécessaire |
| Basculer une branche dans l’espace de travail (ou toute modification du paramètre de connexion) | Admin | Read=Allow (dans le référentiel/le répertoire/la branche cible) |
| Afficher les détails de connexion Git | Administration, Membre, Contributeur | Lecture ou Aucun |
| Consultez l’espace de travail « git status » | 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 apportées à 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 Créer une branche=Autoriser |
Se connecter et synchroniser
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 non 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 perdrez 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 serez invité à confirmer.
Si vous ne sélectionnez pas le contenu à synchroniser, vous ne pouvez pas continuer à travailler tant que vous ne l’avez pas fait :
État de Git
Une fois connecté, l’espace de travail affiche une colonne Git status 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 synchronisé, mais les métadonnées sont différentes
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 le dernier commit avec lequel l’espace de travail est synchronisé
Validations et mises à jour
Volet Contrôle de code source
Au-dessus 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 code 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 dans l’espace de travail.
Dans chaque onglet, les éléments modifiés sont répertoriés avec une icône indiquant le status :
Nouveau
Modifié
Supprimé- Conflit
Commit
- Lorsqu’il existe plusieurs éléments à valider, vous pouvez sélectionner les éléments à valider dans la branche Git.
- Si des mises à jour ont été apportées à la branche Git, les validations sont désactivées jusqu’à ce que vous mettez à jour votre espace de travail.
Update
- Contrairement à la validation et à l’annulation, la commande Mettre à jour met toujours à jour la branche entière 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 la résolution des conflits.
Considérations et limitations
Limitations générales
- Le compte Azure DevOps doit être inscrit auprès de l’utilisateur qui utilise l’espace de travail Fabric.
- Les modèles de requête directe et de proxy ne sont pas pris en charge pour l’instant.
- Les visuels personnalisés privés ne sont pas pris en charge.
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 disposant d’une autorisation 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 Git Integration.
Limitations de synchronisation et de validation
- La limite de taille d’un commit est de 25 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 l’é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.