Partager via

Tutoriel : Pratique avec un exemple de projet dbt dans Microsoft Fabric (préversion)

Le travail dbt dans Fabric vous permet d’exécuter des transformations dbt sans configuration complexe. Vous pouvez orchestrer des builds, des tests et des déploiements de modèles directement dans Fabric à l’aide de fonctionnalités intégrées pour la planification et la supervision. Ce tutoriel vous guide tout au long de l’utilisation d’un exemple de projet pour apprendre les fonctionnalités de travail dbt.

Dans ce tutoriel, vous allez :

  • Créer une tâche dbt avec un projet d'exemple
  • Exécuter des transformations dbt
  • Surveiller et vérifier les résultats

Si vous n’avez pas d’abonnement Fabric, créez un compte d’essai gratuit.

Prerequisites

Avant de commencer ce tutoriel, vous avez besoin des éléments suivants :

  • Accès à un espace de travail Fabric
  • Autorisations de création d’éléments dans l’espace de travail
  • Connaissance de base des concepts dbt (modèles, tests et transformations)

Créer un job dbt avec un exemple de projet

Créez un élément de travail dbt dans votre espace de travail à l’aide d’exemples de fichiers projet.

  1. Accédez à votre espace de travail Fabric.

  2. Sélectionnez +Nouvel élément, puis recherchez et sélectionnez dbt job dans le menu de création d’élément.

  3. Entrez un nom, sélectionnez un emplacement, puis sélectionnez Créer.

    Capture d’écran de la boîte de dialogue créer un travail dans l’interface utilisateur fabric.

  4. Vous voyez trois options pour démarrer un projet dbt. Sélectionnez Pratique avec exemple de projet pour explorer et utiliser un exemple prédéfini.

    Capture d’écran montrant trois options pour démarrer un projet dbt.

  5. Sélectionnez l’exemple de projet Jaffle Shop, qui vous permet d’utiliser des données qui incluent des commandes, des paiements et des jeux de données client.

    Capture d’écran montrant l’option exemple de projet Jaffle Shop.

  6. Sélectionnez un profil pour sélectionner un profil d’adaptateur sur lequel exécuter votre projet dbt.

    Capture d’écran montrant la sélection de profil pour le projet Jaffle Shop.

  7. Créez un entrepôt pour stocker vos exemples de données en sélectionnant l’option Warehouse .

    Capture d’écran montrant la sélection de l’entrepôt Fabric.

  8. Entrez un nom pour l’entrepôt, puis sélectionnez Créer et se connecter.

    Capture d’écran montrant la boîte de dialogue d’affectation de noms de l’entrepôt.

  9. Par défaut, le schéma est défini sur jaffle_shop et l'option d'initialisation des données est sélectionnée. Cette option charge des exemples de données dans le schéma à l’intérieur de l’entrepôt que vous avez créé. Sélectionnez Se connecter.

    Capture d’écran montrant le schéma Jaffle Shop et les options de données initiales.

  10. La configuration du projet se termine en quelques minutes, car les fichiers sont importés. Une fois l’opération terminée, vérifiez que les données d’échantillon ont été amorcées en sélectionnant le bouton Ouvrir l’entrepôt en haut de la page, puis en vérifiant l’entrepôt et le schéma. Vous pouvez également confirmer les exemples de données dans le panneau de sortie en bas de l’écran.

    Capture d’écran montrant la réussite de l’importation du projet Jaffle Shop et des données initiales.

Exécuter la tâche dbt

Exécutez les transformations dbt pour générer des modèles, exécuter des tests et créer des instantanés.

  1. Le panneau supérieur fournit des options pour générer, compiler ou exécuter votre projet. Par défaut, l’opération est définie sur Build, qui exécute tous les modèles, tests et instantanés ensemble pour un workflow complet.

  2. Sélectionnez Générer, puis Exécuter.

    Capture d’écran montrant la commande Build et les boutons Exécuter la commande.

  3. (Facultatif) Exécutez ou excluez des modèles spécifiques à l’aide de sélecteurs avancés. Accédez à Paramètres avancés dans le volet supérieur, sélectionnez Paramètres d’exécution, puis Exécutez avec des sélecteurs avancés.

    dbt run --select my_model 
dbt build --select staging.* 
dbt build --exclude deprecated_models

    Les sélecteurs vous permettent de cibler des parties de votre pipeline pour accélérer l’itération pendant le développement ou les tests.

    Capture d’écran montrant l’option sélecteurs avancés.

Surveiller et vérifier les résultats

Passez en revue les résultats de l’exécution et vérifiez que les transformations se terminent correctement.

  1. Une fois le travail dbt démarré, surveillez sa progression dans l’onglet Sortie en bas de l’écran. L’exécution se termine généralement en quelques minutes.

  2. Confirmez une exécution réussie en vérifiant l’onglet Sortie . L’état indique la réussite de l’exécution.

    Capture d’écran montrant une exécution réussie de la commande de génération.

  3. Vérifiez la sortie en vérifiant les données transformées dans l’entrepôt Fabric. Sélectionnez le bouton Ouvrir l’entrepôt en haut de la page de travail dbt, puis examinez le sample_dbt_project → jaffle_shop schéma.

    Capture d’écran montrant les données transformées dans l’entrepôt Fabric.

  4. Ouvrez l’onglet SQL compilé en bas de la page de tâche dbt pour examiner le code SQL généré et exécuté par dbt. Cet onglet vous aide à déboguer des problèmes ou à optimiser les requêtes.

    Capture d’écran montrant le sql compilé dans le volet inférieur.

  5. Ouvrez la vue de lignée pour visualiser le graphe des dépendances de vos modèles. Cette vue montre comment les flux de données entre les sources et les transformations vous aident à comprendre les relations, à évaluer l’impact en aval et à résoudre les problèmes.

    Capture d’écran montrant la vue de traçabilité dans le volet inférieur.

Nettoyer les ressources

Lorsque vous avez terminé le didacticiel, supprimez la tâche dbt et l'entrepôt pour éviter les coûts supplémentaires.

  1. Ouvrez l’espace de travail Fabric où vous avez créé le job dbt.

  2. Survolez le travail dbt que vous avez créé, sélectionnez Autres options (...), puis sélectionnez Supprimer.

    Capture d’écran montrant le menu Plus d’options pour supprimer le travail dbt de votre espace de travail.

  3. Pour supprimer l’entrepôt, recherchez l’entrepôt dans l’espace de travail où vous avez créé votre travail dbt. Survolez l’entrepôt que vous avez créé, sélectionnez l’ellipse More options (...), puis sélectionnez Delete.

    Capture d’écran montrant le menu Plus d’options pour supprimer l’entrepôt de votre espace de travail.

Contenu connexe

  • Last updated on