Démarrage rapide : Créer votre premier graphe dans Microsoft Fabric

Note

Cette fonctionnalité est actuellement disponible en préversion publique. Cette préversion est fournie sans contrat de niveau de service, et n’est pas recommandée pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure.

Dans ce guide de démarrage rapide, vous créez un graphe de base avec deux nœuds et un bord, puis exécutez une requête. Ce processus prend environ 15 minutes.

Pour obtenir un didacticiel complet qui couvre le modèle de données Adventure Works complet et les scénarios plus avancés, consultez le didacticiel Graph.

Prerequisites

Avant de démarrer ce guide de démarrage rapide, vérifiez que :

1. Graph est disponible dans votre région.

2. Graph est activé dans votre instance Fabric.

   

3. Vous êtes membre d’un espace de travail Fabric ou vous êtes autorisé à créer des éléments dans l’espace de travail. Pour plus d’informations, consultez Espaces de travail dans Microsoft Fabric.

   Important

   La gestion des accès du graphique est limitée à l’espace de travail qui l’héberge. Les utilisateurs en dehors de l’espace de travail ne peuvent pas accéder au graphique. Les utilisateurs de l’espace de travail qui ont accès aux données sous-jacentes du lakehouse peuvent modéliser et interroger le graphique.

Charger un exemple de données

Pour créer votre graphique, commencez par charger des données d'exemple dans un lakehouse de votre espace de travail Fabric.

Télécharger les exemples de données

1. Accédez aux exemples de jeux de données GQL Fabric Graph sur GitHub.

2. Sélectionnez le fichier adventureworks_docs_sample.zip et téléchargez-le sur votre ordinateur local.

   Conseil / Astuce

   Pour télécharger un fichier à partir de GitHub, sélectionnez le fichier, puis sélectionnez l’icône Télécharger le fichier brut .

3. Extrayez le fichier adventureworks_docs_sample.zip téléchargé dans un dossier sur votre ordinateur local.

   Conseil / Astuce

   Dans l’Explorateur de fichiers, cliquez avec le bouton droit sur le fichier zip, puis sélectionnez Extraire tout, puis choisissez un dossier de destination.

Créer un lakehouse

1. Dans Microsoft Fabric, sélectionnez votre espace de travail.

2. Sélectionnez + Nouvel élément.

3. Sélectionnez Store data>Lakehouse.

4. Entrez un nom (par exemple, « AdventureWorksLakehouse »), désactivez l’option Schémas Lakehouse , puis sélectionnez Créer.

   Important

   Graph ne prend actuellement pas en charge les lakehouses ayant activé le schéma lakehouse (préversion).

Charger les données dans des tables

Pour ce guide de démarrage rapide, vous n’avez besoin que de deux tables : adventureworks_customers et adventureworks_orders. Chargez l’exemple complet de dossier de données, puis chargez uniquement ces deux tables.

1. Dans votre lakehouse, pointez sur Fichiers, sélectionnez les points de suspension (...), puis sélectionnez Charger>Charger le dossier.
2. Accédez au dossier extrait et chargez-le. Cette action charge tous les fichiers de données d'exemple dans votre lakehouse.
3. Développez Fichiers et le dossier téléchargé pour afficher les sous-dossiers. Pour ce guide de démarrage rapide, vous devez uniquement charger deux d’entre eux sous forme de tables.
4. Pointez sur le sous-dossier adventureworks_customers, sélectionnez les points de suspension (...), puis choisissez Charger dans des Tables>Nouvelle table.
5. Définissez le type de fichier sur Parquet et sélectionnez Charger.
6. Répétez les étapes 4 à 5 pour le sous-dossier adventureworks_orders .

Créer un modèle de graphe

1. Dans votre espace de travail Microsoft Fabric, sélectionnez + Nouvel élément.

2. Sélectionnez Analyser et entraîner les données>modèle de graphe (aperçu).

   

   Conseil / Astuce

   Vous pouvez également entrer « graph » dans la zone de recherche et appuyer sur Entrée pour rechercher des éléments de graphique.

3. Entrez un nom (par exemple, « MyFirstGraph ») et sélectionnez Créer.

Après avoir créé le modèle de graphique, vous accédez à l’affichage graphique dans lequel vous pouvez voir que le mode par défaut est défini sur Model avec Enregistrer, Obtenir des données, Ajouter un nœud et ajouter des boutons de bord en haut.

Créer un graphique

Pour créer un graphique dans Microsoft Fabric, procédez comme suit dans l’affichage graphique :

1. Sélectionnez Obtenir des données.

2. Dans le catalogue OneLake, sélectionnez votre lakehouse contenant les données Adventure Works.

3. Sélectionnez Se connecter.

4. Sélectionnez les tables adventureworks_customers et adventureworks_orders, puis sélectionnez Charger.

   

Ajouter deux nœuds

1. Sélectionnez Ajouter un nœud.

2. Configurez le premier nœud :

   • Libellé : Client
   • Table de mappage : adventureworks_customers
   • ID de colonne de mappage : CustomerID_K

   

3. Cliquez sur Confirmer.

4. Sélectionnez à nouveau Ajouter un nœud .

5. Configurez le deuxième nœud :

   • Étiquette : Ordre
   • Table de mappage : adventureworks_orders
   • ID de la colonne de mappage : SalesOrderDetailID_K

6. Cliquez sur Confirmer.

Ajouter un bord

1. Sélectionnez Ajouter un bord.

2. Configurez la périphérie :

   • Libellé : achats
   • Table de mappage : adventureworks_orders
   • Nœud source : Client
   • Colonne de mappage de source : CustomerID_FK
   • Nœud cible : Ordre
   • Colonne de mappage cible : SalesOrderDetailID_K

   

3. Cliquez sur Confirmer.

4. Sélectionnez Enregistrer pour charger le graphique.

Interroger votre graphe

Exécutez une requête GQL pour rechercher les cinq premiers clients par nombre de commandes.

1. Sélectionnez le mode Requête .

2. Sélectionnez l’éditeur de code dans le menu supérieur.

3. Entrez la requête GQL suivante dans la zone d’entrée :

   MATCH (c:Customer)-[:purchases]->(o:`Order`)
   RETURN c.fullName AS customer_name, count(o) AS num_orders
   GROUP BY customer_name
   ORDER BY num_orders DESC
   LIMIT 5
   

4. Sélectionnez Exécuter la requête pour afficher les cinq premiers clients par nombre de commandes.

L’image suivante montre la requête GQL et ses résultats :

Félicitations! Vous avez créé votre premier graphe dans Microsoft Fabric et exécuté une requête sur celle-ci.

Étapes suivantes

• Tutoriel graph : Créer un graphique complet avec plusieurs nœuds, arêtes et requêtes
• Guide du langage GQL - Apprendre la syntaxe GQL
• Qu’est-ce que Graph dans Microsoft Fabric ? - En savoir plus sur les concepts de graphe