Tutoriel : Utiliser des bibliothèques de variables pour personnaliser et partager des configurations d’élément

Ce tutoriel vous montre comment utiliser du contenu dynamique dans des pipelines Microsoft Fabric. Lorsque vous créez un élément de bibliothèque de variables et ajoutez-y des variables, vous pouvez automatiser les valeurs pour différentes étapes de votre pipeline de déploiement. Dans ce tutoriel, vous copiez des données d’un lakehouse vers un autre. Ensuite, vous utilisez la bibliothèque de variables pour définir les valeurs source et de destination de l’activité de copie.

Dans ce tutoriel, vous allez :

Le diagramme suivant montre la disposition de l’espace de travail pour ce didacticiel.

Conditions préalables

• Un compte de locataire Fabric avec un abonnement actif. Créez gratuitement un compte.

• Le commutateur de locataire suivant est activé à partir du portail d’administration :

  • Les utilisateurs peuvent créer des éléments Fabric

  L’administrateur client, l’administrateur de capacité ou l’administrateur de l’espace de travail peut activer ces commutateurs, en fonction des paramètres de votre organisation.

Créer l’espace de travail Stage LHs, SourceLH_Stage lakehouse avec des exemples de données et Pipeline_Stage pipeline

Tout d’abord, créez un espace de travail et un lakehouse à utiliser comme données intermédiaires initiales :

1. Accédez à Power BI.

2. Dans la barre latérale, sélectionnez Espace de travail.

3. Créez un espace de travail. Appelez-le étape LHs.

   

4. Créez une lakehouse :

   1. En haut de l’espace de travail, sélectionnez Nouvel élément.

   2. Sous Stocker des données, sélectionnez Lakehouse.

      

   3. Entrez le nom SourceLH_Stage, puis sélectionnez Créer.

5. Créez un pipeline :

   1. Dans le lakehouse, sélectionnez Nouveau pipeline.

      

   2. Entrez le nom Pipeline_Stage, puis sélectionnez Créer.

   3. Dans l’Assistant Copier des données dans Lakehouse , dans la page Choisir une source de données , sélectionnez Exemples de données.

      

   4. Sélectionnez Jours fériés.

      

   5. Une fois l’exemple de données chargé, sélectionnez Suivant.

   6. Dans la page Se connecter à la destination des données , sélectionnez Suivant.

      

   7. Dans la page Vérifier + enregistrer , sélectionnez Enregistrer + Exécuter.

      

Créer les LH sources avec l’espace de travail Variables

À présent, créez l’espace de travail que vous allez utiliser avec votre bibliothèque de variables :

1. Accédez à Power BI.

2. Dans la barre latérale, sélectionnez Espace de travail.

3. Créez un espace de travail. Appelez-le LHs source avec des variables.

Créer les SourceLH_Dev, SourceLH_Test et SourceLH_Prod lakehouses

Ensuite, créez les trois lakehouses à utiliser avec la bibliothèque de variables :

1. Créez le premier lakehouse :

   1. Dans la barre latérale, sélectionnez les LH sources avec l’espace de travail Variables.

   2. Sélectionnez Nouvel élément.

   3. Sous Stocker des données, sélectionnez Lakehouse.

   4. Entrez le nom SourceLH_Dev, puis sélectionnez Créer.

2. Créez la deuxième lakehouse en suivant les étapes précédentes. Nommez-le SourceLH_Test.

3. Créez le troisième lakehouse en suivant les étapes précédentes. Nommez-le SourceLH_Prod.

4. Dans la barre latérale, sélectionnez les LH sources avec l’espace de travail Variables et assurez-vous qu’elle contient toutes les lakehouses nouvellement créées.

Obtenir les ID d’espace de travail et les ID d’objet pour lakehouses

Dans ces étapes, vous obtenez les identificateurs uniques à utiliser dans votre bibliothèque de variables :

1. Dans Power BI, dans la barre latérale, sélectionnez l’espace de travail Stage LHs .

2. Dans l’espace de travail, sélectionnez la SourceLH_Stage lakehouse.

3. Copiez l’ID de l’espace de travail et l’ID d’objet lakehouse dans l’URL.

   

4. Répétez les étapes précédentes pour les SourceLH_Dev et SourceLH_Test lakehouses dans les LHs sources avec l’espace de travail Variables.

Créer une bibliothèque de variables avec des variables

À présent, créez la bibliothèque de variables :

1. Dans les LH sources avec l’espace de travail Variables, sélectionnez Nouvel élément.

2. Sous Développer des données, sélectionnez **Bibliothèque de variables **.

   

3. Nommez les variables WS de la bibliothèque, puis sélectionnez Créer.

4. Sélectionnez Nouvelle variable.

   

5. Créez les variables suivantes :

   Nom	Catégorie	Ensemble de valeurs par défaut
   Source_LH	Chaîne	<GUID de SourceLH_Stage lakehouse>
   Source_WSID	Chaîne	<GUID de l’espace de travail SourceLH_Stage>
   Destination_LH	Chaîne	<GUID de SourceLH_Dev lakehouse>
   Destination_WSID	Chaîne	<GUID de l’espace de travail SourceLH_Dev>
   SourceTable_Name	Chaîne	Processed
   DestinationTable_Name	Chaîne	DevCopiedData

   

6. Cliquez sur Enregistrer.

Créer d’autres jeux de valeurs

Dans ces étapes, vous ajoutez les jeux de valeurs de remplacement à votre bibliothèque de variables :

1. Créez le premier jeu de valeurs :

   1. Dans la bibliothèque de variables WS Variables , sélectionnez Ajouter un jeu de valeurs.

   2. Entrez Test VS pour le nom, puis sélectionnez Créer.

   3. Créez les variables suivantes :

      Nom	Catégorie	Ensemble de valeurs par défaut
      Source_LH	Chaîne	<GUID de SourceLH_Dev lakehouse>
      Source_WSID	Chaîne	<GUID de l’espace de travail SourceLH_Dev>
      Destination_LH	Chaîne	<GUID de SourceLH_Test lakehouse>
      Destination_WSID	Chaîne	<GUID de l’espace de travail SourceLH_Test>
      SourceTable_Name	Chaîne	DevCopiedData
      DestinationTable_Name	Chaîne	TestCopiedData

   4. Sélectionnez Enregistrer>d’accord.

2. Créez le deuxième jeu de valeurs :

   1. Sélectionnez Ajouter un jeu de valeurs.

   2. Entrez Prod VS pour le nom, puis sélectionnez Créer.

   3. Créez les variables suivantes :

      Nom	Catégorie	Ensemble de valeurs par défaut
      Source_LH	Chaîne	<GUID de SourceLH_Test lakehouse>
      Source_WSID	Chaîne	<GUID de l’espace de travail SourceLH_Test>
      Destination_LH	Chaîne	<GUID de SourceLH_Prod lakehouse>
      Destination_WSID	Chaîne	<GUID de l’espace de travail SourceLH_Prod>
      SourceTable_Name	Chaîne	TestCopiedData
      DestinationTable_Name	Chaîne	ProdCopiedData

      

   4. Sélectionnez Enregistrer>d’accord.

Créer le pipeline Pipeline_Deploy et déclarer des variables

Dans ces étapes, vous créez votre pipeline et déclarez vos variables :

1. Dans les LH sources avec l’espace de travail Variables, sélectionnez Nouvel élément.

2. Sous Obtenir des données, sélectionnez Pipeline.

   

3. Entrez le nom Pipeline_Deploy, puis sélectionnez Créer.

4. Sélectionnez Copier des données>Ajouter au canevas.

   

5. Sélectionnez le canevas afin que le focus soit désactivé pour copier des données.

6. Sélectionnez **Variables de bibliothèque **.

   

7. Sélectionnez Nouveau, puis ajoutez les variables suivantes :

   Nom	Bibliothèque	Nom de la variable	Catégorie
   SourceLH	WS Variables	Source_LH	Chaîne
   SourceWSID	WS Variables	Source_WSID	Chaîne
   DestinationLH	WS Variables	Destination_LH	Chaîne
   DestinationWSID	WS Variables	Destination_WSID	Chaîne
   SourceTableName	WS Variables	SourceTable_Name	Chaîne
   DestinationTableName	WS Variables	DestinationTable_Name	Chaîne

   

8. Cliquez sur Enregistrer.

Configurer la connexion source pour le pipeline Pipeline_Deploy

Dans ces étapes, vous configurez la connexion source pour votre pipeline :

1. Dans l’espace de travail LH source avec variables , accédez à Pipeline_Deploy.

2. Dans le canevas, sélectionnez Copier des données afin que le focus soit sur Copier des données.

3. Sélectionnez Source.

4. Configurer SourceLH :

   1. Sous Connexion source>, sélectionnez Ajouter du contenu dynamique.

   2. Sélectionnez les points de suspension (...), puis sélectionnez **Variables de bibliothèque **.

   3. Sélectionnez SourceLH. Il remplit la boîte avec @pipeline().libraryVariables.SourceLH. Cliquez sur OK.

      

5. Configurer SourceWSID :

   1. SousID de l’espace de travail>, sélectionnez Ajouter du contenu dynamique.

   2. Sélectionnez les points de suspension (...), puis sélectionnez **Variables de bibliothèque **.

   3. Sélectionnez SourceWSID. Il remplit la boîte avec @pipeline().libraryVariables.SourceWSID. Cliquez sur OK.

      

6. Configurer SourceTableName :

   1. Sous Table source>, sélectionnez Entrée manuellement, sélectionnez Nom de la table, puis ajoutez du contenu dynamique.

   2. Sélectionnez les points de suspension (...), puis sélectionnez **Variables de bibliothèque **.

   3. Sélectionnez SourceTableName. Il remplit la boîte avec @pipeline().libraryVariables.SourceTableName. Cliquez sur OK.

      

7. Maintenant que la connexion source est configurée, vous pouvez la tester. Sélectionnez Aperçu des données, puis sélectionnez OK dans le menu volant. Une fois les données remplies, vous pouvez fermer l’aperçu des données.

   

Configurer la connexion de destination pour le pipeline Pipeline_Deploy

Dans ces étapes, vous configurez la connexion de destination pour votre pipeline :

1. Dans l’espace de travail LH source avec variables , accédez à Pipeline_Deploy.

2. Dans le canevas, sélectionnez Copier des données afin que le focus soit sur Copier des données.

3. Sélectionnez Destination.

4. Configurer SourceLH :

   1. Sous Connexion de destination>, sélectionnez Ajouter du contenu dynamique.

   2. Sélectionnez les points de suspension (...), puis sélectionnez **Variables de bibliothèque **.

   3. Sélectionnez SourceLH. Il remplit la boîte avec @pipeline().libraryVariables.DestinationLH. Cliquez sur OK.

      

5. Configurer DestinationWSID :

   1. SousID de l’espace de travail>, sélectionnez Ajouter du contenu dynamique.

   2. Sélectionnez les points de suspension (...), puis sélectionnez **Variables de bibliothèque **.

   3. Sélectionnez DestinationWSID. Il remplit la boîte avec @pipeline().libraryVariables.DestinationWSID. Cliquez sur OK.

      

6. Configurer DestinationTableName :

   1. SousTable>, sélectionnez Entrée manuellement, sélectionnez Nom de la table, puis ajoutez du contenu dynamique.

   2. Sélectionnez les points de suspension (...), puis sélectionnez **Variables de bibliothèque **.

   3. Sélectionnez DestinationTableName. Il remplit la boîte avec @pipeline().libraryVariables.DestinationTableName. Cliquez sur OK.

      

7. Maintenant que la connexion de destination est configurée, enregistrez le pipeline et sélectionnez Exécuter. Vérifiez qu’elle s’exécute correctement.

   

Créer le pipeline de déploiement

À présent, créez votre pipeline de déploiement :

1. Dans les LH sources avec l’espace de travail Variables, sélectionnez Créer un pipeline de déploiement.

2. Nommez le pipeline Deployment_Pipeline_Var, puis sélectionnez Suivant.

   

3. Dans le pipeline de déploiement, sélectionnez Créer et continuer.

   

4. Pour la phase de développement :

   1. Dans la liste déroulante, sélectionnez Sources LHs avec variables pour l’espace de travail. Sélectionnez ensuite la coche Affecter .

      

   2. Sélectionnez Continuer. La phase doit maintenant être remplie avec les éléments de l’espace de travail.

      

5. Pour la phase de test :

   1. Cochez la case en haut pour sélectionner tous les éléments. Désactivez ensuite la case à cocher pour la SourceLH_Dev lakehouse.

   2. Sélectionnez le bouton Déployer . Sélectionnez Déployer à nouveau. La phase de test doit maintenant être remplie.

      

6. Pour la phase de production :

   1. Cochez la case en haut pour sélectionner tous les éléments. Désactivez ensuite la case à cocher de la SourceLH_Test lakehouse.

   2. Sélectionnez le bouton Déployer . Sélectionnez Déployer à nouveau. La phase de production doit maintenant être remplie.

      

Définir l’ensemble actif de la bibliothèque de variables pour chaque étape

Dans ces étapes, vous configurez l’ensemble actif pour chaque étape de votre pipeline de déploiement :

1. Configurez l’ensemble actif pour la phase de test :

   1. Dans la barre latérale, sélectionnez le pipeline Deployment_Pipeline_Var .

   2. Sélectionnez la phase de test .

      

   3. Sélectionnez Variables WS.

   4. Sélectionnez les points de suspension (...), puis sélectionnez Définir comme actif. Sélectionnez le bouton Définir comme actif .

      

      L’ensemble actif est maintenant configuré.

      

   5. Sélectionnez Enregistrer>d’accord.

2. Configurez l’ensemble actif pour l’étape Prod :

   1. Dans la barre latérale, sélectionnez le pipeline Deployment_Pipeline_Var .

   2. Sélectionnez l’étape Prod .

   3. Sélectionnez Variables WS.

   4. Sélectionnez les points de suspension (...), puis sélectionnez Définir comme actif. Sélectionnez le bouton Définir comme actif .

   5. Sélectionnez Enregistrer>d’accord.

Vérifier et tester la bibliothèque de variables

Maintenant que vous avez configuré la bibliothèque de variables et configuré tous les ensembles actifs pour chaque étape du pipeline de déploiement, vous pouvez les vérifier :

1. Vérifiez la SourceLHs_Dev lakehouse :

   1. Dans l’espace de travail LH source avec variables , sélectionnez la SourceLHs_Dev lakehouse.

   2. Remplacez la connexion entre Lakehouse et le point de terminaison d’analytique SQL.

   3. Dans l’Explorateur, développez Schémas>dbo>Tables.

   4. Vérifiez que la table DevCopiedData s’affiche.

      

2. Basculez vers la SourceLHs_Test lakehouse et répétez les étapes précédentes.

   La table TestCopiedData ne doit pas apparaître, car vous n’avez pas encore exécuté le pipeline avec le jeu actif VS de test .

3. Basculez vers la SourceLHs_Prod lakehouse et répétez les étapes précédentes.

   La table ProdCopiedData ne doit pas apparaître, car vous n’avez pas encore exécuté le pipeline avec le jeu actif Prod VS .

4. Vérifiez l’étape de test du pipeline Deployment_Pipeline_Var :

   1. Basculez vers le pipeline Deployment_Pipeline_Var et sélectionnez l’étape de test .

   2. Sélectionnez le pipeline Pipeline_Deploy .

   3. Sélectionnez Exécuter. Ce processus doit se terminer correctement.

5. Vérifiez à nouveau le SourceLHs_Test lakehouse :

   1. Basculez vers la SourceLHs_Test lakehouse.

   2. Remplacez la connexion entre Lakehouse et le point de terminaison d’analytique SQL.

   3. Dans l’Explorateur, développez Schémas>dbo>Tables.

   4. Vérifiez que la table TestCopiedData s’affiche.

      

6. Vérifiez l’étape de production du pipeline Deployment_Pipeline_Var :

   1. Basculez vers le pipeline Deployment_Pipeline_Var et sélectionnez l’étape De production .

   2. Sélectionnez le pipeline Pipeline_Deploy .

   3. Sélectionnez Exécuter. Ce processus doit se terminer correctement.

7. Vérifiez à nouveau la SourceLHs_Prod lakehouse :

   1. Basculez vers la SourceLHs_Prod lakehouse.

   2. Remplacez la connexion entre Lakehouse et le point de terminaison d’analytique SQL.

   3. Dans l’Explorateur, développez Schémas>dbo>Tables.

   4. Vérifiez que la table ProdCopiedData s’affiche.

Personnaliser les valeurs des variables dans Git (facultatif)

Pour voir comment la bibliothèque de variables est représentée dans Git ou pour modifier les variables à partir d’un référentiel Git :

1. Dans l’espace de travail, sélectionnez Contrôle de code source et connectez l’espace de travail à un dépôt Git.

2. Dans le volet contrôle de code source , sélectionnez Valider pour envoyer (push) le contenu de l’espace de travail au dépôt Git.

   Le dépôt Git a un dossier pour chaque élément de l’espace de travail. Un dossier appelé variables WS. VariableLibrary représente l’élément de bibliothèque de variables. Pour plus d’informations sur le contenu de ce dossier, consultez la bibliothèque de variables CI/CD.

3. Comparez les fichiersProdVS.json et TestVS.json dans le dossier valueSets . Vérifiez que la overrides variable est définie sur les différentes valeurs. Vous pouvez modifier ces valeurs directement dans l’interface utilisateur ou en modifiant ce fichier dans Git et en le mettant à jour dans l’espace de travail.

   {
    "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
    "valueSetName": "Test VS",
    "overrides": [
     {
      "name": "Source_LH",
      "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43"
     },
     {
      "name": "DestinationTableName",
      "value": "TestCopiedData"
     }
    ]
   }
   

   {
    "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
    "valueSetName": "Prod VS",
    "overrides": [
     {
      "name": "Source_LH",
      "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b"
     },
     {
      "name": "DestinationTableName",
      "value": "ProdCopiedData"
     }
    ]
   }
   

Contenu connexe

• Tutoriel : Gestion du cycle de vie dans Fabric
• Créer et gérer des bibliothèques de variables