Concevoir un schéma de graphique dans Microsoft Fabric

Un schéma de graphe est la collection de types de nœuds, de types de bord et de leurs propriétés qui définissent la structure de votre graphe. Un schéma de graphe bien conçu facilite l’interrogation, la maintenance et l’extension de vos données. Cet article fournit les meilleures pratiques pour transformer des données tabulaires dans un lakehouse en un graphique de propriétés labeled property graph efficace dans Microsoft Fabric.

Utilisez ces instructions avant de commencer la modélisation dans l’éditeur de modèle de graphe. Pour obtenir des instructions pas à pas sur la création de nœuds et de bords, consultez le didacticiel sur le graphique. Les exemples de cet article utilisent l’exemple de jeu de données Adventure Works.

Prerequisites

• Un espace de travail Fabric avec un lakehouse, qui contient vos tables sources.
• Connaissance de l’éditeur de modèle de graphe.
• Facultatif : l’exemple de jeu de données Adventure Works pour suivre les exemples de cet article.

Comprendre les types de nœuds et les types de périphérie

Avant de concevoir un schéma, comprenez ces concepts fondamentaux :

Un type de nœud définit un type d’entité dans votre graphique, tel qu’un client, un produit ou une commande. Elle comprend :

• Étiquette, qui est le nom qui identifie cette catégorie de nœud. Par exemple : Customer. Vous utilisez l’étiquette dans les requêtes pour faire référence aux nœuds de ce type.
• Table de mappage, qui est la table lakehouse qui fournit les données sources pour le type de nœud. Par exemple, la table adventureworks_customers .
• Colonne clé qui identifie de manière unique chaque nœud ( ID étiqueté dans l’éditeur de modèle de graphique). Par exemple : CustomerID_K.
• Propriétés, qui sont des colonnes de la table qui deviennent des attributs sur chaque nœud. Par exemple, FirstName, LastNameet EmailAddress.

Un nœud est une instance individuelle d’un type de nœud : une ligne dans la table de mappage. Par exemple, chaque ligne de adventureworks_customers devient un Customer nœud.

Un type de périphérie définit un type de relation entre deux types de nœuds. Elle comprend :

• Étiquette, qui est le nom qui identifie cette catégorie de relation. Par exemple : purchases.
• Table de mappage qui contient les données de relation entre les nœuds source et cible. Par exemple, la table adventureworks_orders .
• Type de nœud source et type de nœud cible que l'arête connecte. Par exemple, Customer en tant que source et Order en tant que cible.

Un bord est une instance individuelle d’un type de périphérie : une ligne dans la table de mappage qui connecte deux nœuds spécifiques.

Identifier les entités et les relations

Commencez par identifier les entités (éléments) et les relations (connexions ) dans vos données. Les entités deviennent des types de nœuds. Les connexions entre entités deviennent des types d'arêtes.

Posez ces questions sur vos tables sources :

• Quelles sont les entités principales ? Les lignes qui représentent des éléments réels distincts sont des candidats pour les types de nœuds. Par exemple, les clients, les produits, les commandes et les employés.
• Comment ces entités sont-elles liées les unes aux autres ? Les colonnes qui référencent des lignes dans une autre table (clés étrangères) suggèrent des types de bord. Par exemple, CustomerID_FK dans une orders table pointe vers la customers table, ce qui suggère la modélisation d’un purchases bord.
• Existe-t-il des entités incorporées ? Une colonne à l'intérieur d'une table peut représenter une entité distincte qu'il convient d'extraire en tant que type de nœud à part entière. Pour obtenir un exemple, consultez Choisir des types de nœuds. Pour obtenir une procédure pas à pas, consultez Ajouter plusieurs types de nœuds et de périphérie à partir d’une table de mappage.

Choisir des types de nœuds

Créez un type de nœud pour chaque entité que vous devez interroger ou parcourir indépendamment. Utilisez ces instructions :

Exemple: Dans le jeu de données Adventure Works, Country commence en tant que colonne sur la employees table. Si vous devez interroger « quels employés vivent dans le même pays ? » ou « quels pays ont le plus d’employés ? », extrayez Country en son propre type de nœud. Si vous n’avez besoin d’afficher le pays d’un employé qu’en tant qu’étiquette, laissez-le comme propriété.

Choisir des colonnes clés

Chaque type de nœud nécessite une colonne clé (ou une clé composée) qui identifie de manière unique chaque nœud. Choisissez soigneusement les clés :

• Utilisez des identificateurs uniques existants à partir de vos tables sources. Par exemple, CustomerID_K ou ProductID_K.
• Évitez les clés de substitution qui n’ont pas de signification métier , sauf si aucune clé naturelle n’existe. Par exemple, préférez CustomerID à un numéro de ligne s'incrémentant automatiquement.
• Utilisez des clés composées lorsqu’une seule colonne ne garantit pas l’unicité. Par exemple, un ProductVersion nœud peut avoir besoin à la fois ProductID et VersionNumber en tant que clé.
• Mettre en correspondance les types de données entre les colonnes clés et les colonnes clés étrangères utilisées dans les mappages de périphérie. Les types incompatibles provoquent des échecs lors de la création d'arêtes.

Choisir des types de bordure

Les types edge définissent les relations entre les types de nœuds. Chaque type de périphérie connecte un type de nœud source à un type de nœud cible via une table de mappage.

Suivez ces instructions :

• Utilisez des étiquettes descriptives qui agissent comme des verbes ou des expressions verbales. Par exemple, purchases, , sells, livesInet belongsTo. Un bord bien nommé facilite la lecture des requêtes.
• Réfléchissez soigneusement à la direction. Les arêtes du graphique sont dirigées. Choisissez la direction qui représente le mieux la relation réelle. Par exemple, Customer --les achats -->Order se lit plus naturellement que Order --purchasedBy -->Customer.
• Donnez des noms distincts aux types de périphérie qui connectent différentes paires de types de nœud. Si « commande vendue par l'employé » et « commande achetée par le client » se connectent à Order, nommez-les sells et purchases plutôt que de leur donner à la fois la même étiquette. Pour plus d’informations, consultez les limitations de création de périphérie.

Ajouter des propriétés aux types d'arêtes

Contrairement aux types de nœuds, les types de périphérie commencent sans propriétés. Vous pouvez éventuellement ajouter des propriétés lorsque les données décrivent la relation elle-même plutôt que l’un ou l’autre point de terminaison. Les propriétés edge sont les plus utiles lorsque vous écrivez des requêtes GQL qui doivent filtrer, agréger ou retourner des données sur la relation elle-même.

Pour ajouter une propriété, double-cliquez sur un type de bord dans l’éditeur de modèle de graphique pour ouvrir la boîte de dialogue Modifier le schéma de périmètre , sélectionnez Ajouter une propriété, puis choisissez une colonne dans la table de mappage.

Quand ajouter des propriétés de périphérie : Si une colonne répond à « combien ? », « quand ? » ou « de quelle façon ? » à propos de la connexion entre deux nœuds, elle appartient à la périphérie, et non sur l’un ou l’autre des nœuds.

Exemple : Dans le jeu de données Adventure Works, l'arête contains relie Order à Product via la table adventureworks_orders. Colonnes telles que OrderQty, UnitPrice et LineTotal décrivent la relation - combien d’un produit figuraient dans une commande spécifique, à quel prix. Les colonnes comme OrderDate ou ShipDate décrivent l’ordre lui-même et appartiennent au type de Order nœud, et non sur le bord.

Supprimer les propriétés inutiles

Lorsque vous créez un type de nœud à partir d’une table de mappage, chaque colonne de la table devient une propriété par défaut. Les propriétés excessives augmentent le stockage, les requêtes lentes et rendent le graphique plus difficile à gérer. Pour ces raisons, supprimez les propriétés dont vous n’avez pas besoin pour les requêtes ou l’analyse.

Pour chaque type de nœud, conservez uniquement les propriétés suivantes :

• Requis pour l’unicité du nœud (colonnes clés)
• Utilisé dans WHERE filtres ou RETURN projections dans vos requêtes
• Nécessaire pour l’analyse ou la visualisation en aval

Pour plus d’informations sur la façon dont le nombre de propriétés affecte les performances des requêtes, consultez Renvoyer uniquement les propriétés dont vous avez besoin.

Choisir des types de données

Sélectionnez le type de données le plus spécifique pour chaque propriété. Les types appropriés améliorent l’efficacité du stockage et les performances des requêtes :

• Utilisez INT ou UINT64 pour les identificateurs numériques et les nombres. Les comparaisons numériques sont plus rapides que les comparaisons de chaînes.
• Utilisez ZONED DATETIME pour les horodatages au lieu des dates formatées en chaîne.
• Utilisez BOOLEAN pour les indicateurs true/false au lieu de valeurs de chaîne comme "yes" ou "no".

Pour obtenir la liste complète des types pris en charge, consultez limitations actuelles : types de données.

Modèles courants de conversion de tableaux en graphiques

Le tableau suivant résume la façon dont certaines structures de données tabulaires courantes se traduisent en éléments de graphique :

Pour obtenir une procédure pas à pas du modèle d’entité incorporée, consultez Ajouter plusieurs types de nœuds et de périphérie à partir d’une table de mappage.

Modifier votre schéma de graphe

Graph ne prend pas en charge l’évolution du schéma. Une fois que vous avez enregistré un modèle de graphe, la structure des types de nœuds, des types de périphérie et leurs propriétés sont fixes. Pour apporter des modifications structurelles, telles que l’ajout d’une propriété à un type de nœud, la suppression d’un type de périphérie ou la modification d’une colonne clé, vous devez créer un modèle de graphe et recharger vos données.

Pour modifier votre schéma de graphe :

1. Dans votre espace de travail, créez un nouvel élément de graphique qui se connecte au même lakehouse.
2. Dans l’éditeur de modèle de graphique, ajoutez les types de nœuds et les types de bord dont vous avez besoin, y compris les propriétés nouvelles ou modifiées.
3. Configurez les colonnes clés et les mappages de périphérie. Assurez-vous que les types de données correspondent entre les colonnes clés et les colonnes clés étrangères.
4. Sélectionnez Enregistrer pour ingérer des données et générer le nouveau graphique.
5. Mettez à jour tous les ensembles de requêtes pour qu’ils pointent vers le nouveau graphique.
6. Une fois que vous avez vérifié que le nouveau graphique fonctionne comme prévu, supprimez l’élément de graphe d’origine si vous n’en avez pas besoin.

Contenu connexe

• Convertir des données relationnelles en modèle de graphe
• Tutoriel : Présentation du graphique
• Types de graphiques GQL
• Optimiser les performances des requêtes GQL
• Graphes de propriétés étiquetés
• Limites actuelles