Contrôle de code source (préversion)

S’applique à :✅ Entrepôt dans Microsoft Fabric

Cet article explique comment l’intégration de Git et les pipelines de déploiement fonctionnent pour les entrepôts dans Microsoft Fabric. Découvrez comment configurer une connexion à votre dépôt, gérer vos entrepôts et les déployer dans différents environnements. Le contrôle de code source pour Fabric Warehouse est actuellement une fonctionnalité en préversion.

Vous pouvez utiliser l’intégration Git et les pipelines de déploiement pour différents scénarios :

• Utiliser des projets de base de données Git et SQL pour gérer les modifications incrémentielles, la collaboration d’équipe, l’historique des commits dans des objets de base de données individuels.
• Utiliser des pipelines de déploiement pour promouvoir les modifications de code dans différents environnements de préproduction et de production.

Intégration Git

L’intégration de Git dans Microsoft Fabric permet aux développeurs d’intégrer leurs processus de développement, leurs outils et leurs meilleures pratiques directement dans la plateforme Fabric. Elle permet aux développeurs qui développent dans Fabric de :

• Sauvegarder et versionner leur travail
• Revenir aux étapes précédentes si nécessaire
• Collaborer avec d’autres personnes ou travailler seul à l’aide de branches Git
• Appliquer les capacités des outils de contrôle de code source familiers pour gérer les éléments Fabric

Pour plus d’informations sur le processus d’intégration Git, consultez :

• Qu’est-ce que l’intégration de Microsoft Fabric Git ?
• Concepts de base de l’intégration Git
• Démarrer avec l’intégration Git

Configurer une connexion au contrôle de code source

À partir de la page Paramètres de l’espace de travail, vous pouvez facilement configurer une connexion à votre dépôt pour commiter et synchroniser les modifications.

1. Pour configurer la connexion, consultez Démarrer avec l’intégration de Git. Suivez les instructions pour vous connecter à un dépôt Git à Azure DevOps ou GitHub en tant que fournisseur Git.
2. Une fois connectés, vos éléments, y compris les entrepôts, apparaissent dans le panneau Contrôle de code source.
3. Une fois que vous avez correctement connecté les instances de l’entrepôt au dépôt Git, vous voyez la structure des dossiers de l’entrepôt dans le dépôt. Vous pouvez maintenant exécuter des opérations telles que la création d’une demande de tirage.

Projets de base de données pour un entrepôt dans Git

L’image suivante est un exemple de structure de fichiers de chaque élément d’entrepôt dans le dépôt :

Lorsque vous commitez l’élément d’entrepôt dans le dépôt Git, l’entrepôt est converti au format de code source, en tant que projet de base de données SQL. Un projet SQL est une représentation locale d’objets SQL qui comprennent le schéma d’une base de données unique, comme des tables, des procédures stockées ou des fonctions. La structure de dossiers des objets de base de données est organisée par schéma/type d’objet. Chaque objet de l’entrepôt est représenté par un fichier .sql qui contient sa définition DDL (Data Definition Language). Les données de table d’entrepôt et les fonctionnalités de sécurité SQL ne sont pas incluses dans le projet de base de données SQL.

Les requêtes partagées sont également commitées dans le dépôt, et héritent du nom sous lequel elles sont enregistrées.

Pipelines de déploiement

Vous pouvez également utiliser des pipelines de déploiement pour déployer votre code d’entrepôt dans différents environnements : développement, test, et production. Les pipelines de déploiement n’exposent pas de projet de base de données.

Effectuez les étapes suivantes pour exécuter votre déploiement d’entrepôt à l’aide du pipeline de déploiement.

1. Créez un pipeline de déploiement ou ouvrez un pipeline de déploiement existant. Pour plus d’informations, consultez Bien démarrer avec les pipelines de déploiement.
2. Affectez des espaces de travail à différentes phases en fonction de vos objectifs de déploiement.
3. Sélectionnez, affichez et comparez des éléments, y compris des entrepôts entre différentes phases, comme illustré dans l’exemple suivant.
4. Sélectionnez Déployer pour déployer vos entrepôts dans les phases Développement, Test, et Production.

Pour plus d’informations sur le processus des pipelines de déploiement Fabric, consultez Présentation des pipelines de déploiement.

Limitations dans le contrôle de code source

• Les fonctionnalités de sécurité SQL doivent être exportées/migrées à l’aide d’une approche basée sur des scripts. Envisagez d’utiliser un script post-déploiement dans un projet de base de données SQL, que vous pouvez configurer en ouvrant le projet avec l’extension Projets SQL Database disponible dans Visual Studio Code.

Limitations de l’intégration Git

• Actuellement, si vous utilisez ALTER TABLE pour ajouter une contrainte ou une colonne dans le projet de base de données, la table est supprimée et recréée lors du déploiement, ce qui entraîne une perte de données. Vous pouvez adopter la solution de contournement suivante pour conserver la définition de table et les données :
  • Créez une nouvelle copie de la table dans l’entrepôt, à l’aide de CREATE TABLE et INSERT, CREATE TABLE AS SELECT, ou Cloner la table.
  • Modifiez la nouvelle définition de table avec de nouvelles contraintes ou colonnes, comme vous le souhaitez, à l’aide de ALTER TABLE.
  • Supprimez l’ancienne table.
  • Renommez la nouvelle table avec le nom de l’ancienne table à l’aide de sp_rename.
  • Modifiez la définition de l’ancienne table dans le projet de base de données SQL exactement de la même façon. Le projet de base de données SQL de l’entrepôt dans le contrôle de code source et l’entrepôt dynamique doivent maintenant correspondre.
• Actuellement, vous ne devez pas créer de flux de données Gen2 avec une destination de sortie vers l’entrepôt. Le commit et la mise à jour à partir de Git seraient bloqués par un nouvel élément nommé DataflowsStagingWarehouse qui apparaît dans le dépôt.
• L'intégration Git de Fabric ne prend pas en charge le point de terminaison SQL Analytics.
• Les dépendances entre les éléments, le séquencement d'éléments et les décalages de synchronisation entre le point d'accès analytique SQL et l'entrepôt affectent les workflows de « bifurcation vers un espace de travail nouveau/existant » et de « changement de branche » pendant le développement et l'intégration continue.

Limitations des pipelines de déploiement

• Actuellement, si vous utilisez ALTER TABLE pour ajouter une contrainte ou une colonne dans le projet de base de données, la table est supprimée et recréée lors du déploiement, ce qui entraîne une perte de données.
• Actuellement, vous ne devez pas créer de flux de données Gen2 avec une destination de sortie vers l’entrepôt. Le déploiement serait bloqué par un nouvel élément nommé DataflowsStagingWarehouse qui apparaît dans le pipeline de déploiement.
• Les pipelines de déploiement Fabric ne prennent pas en charge l’élément de point de terminaison pour l’analyse SQL.
• Dépendances inter-éléments, séquencement d’éléments et écarts de synchronisation entre le point de terminaison d’analyse SQL et l’entrepôt impactent les flux de travail des pipelines de déploiement Fabric.

Contenu connexe

• Développement et déploiement
• Démarrer avec l’intégration Git