Consultez un diagramme d’entité dans la base de données KQL

Dans Real-Time Intelligence, vous pouvez afficher la traçabilité et la relation des éléments de base de données KQL. La vue vous permet d’explorer visuellement les relations entre les entités de base de données et de vous aider à comprendre le flux de données de la source à la destination, en fournissant une représentation claire du graphique. En utilisant le diagramme d’entités, vous pouvez gérer efficacement votre base de données et mieux comprendre comment ces entités interagissent. Cette représentation visuelle des entités simplifie la gestion des bases de données et vous aide à optimiser vos structures de données, ce qui facilite le suivi des dépendances et prend des mesures rapidement.

Pour plus d’informations sur la lineage de l’espace de travail dans Fabric, consultez Lineage.

Prerequisites

Pour les utilisateurs qui souhaitent activer les détails d’ingestion :

  • Autorisations Administrateur de base de données ou Moniteur de base de données pour afficher les détails d’ingestion dans le diagramme d’entité. Pour plus d’informations, consultez Contrôle d’accès en fonction du rôle.

Ouvrir la vue diagramme d’entité

Pour accéder à la vue, accédez à votre base de données KQL souhaitée et sélectionnez Diagramme d’entité.

Capture d’écran montrant le bouton d’affichage du diagramme d’entité.

Que voyez-vous dans une vue de diagramme d’entité ?

Lorsque vous ouvrez la vue diagramme d’entité, vous voyez les dépendances entre tous les éléments de la base de données KQL.

La vue diagramme d’entité affiche les informations suivantes :

Vous pouvez sélectionner un élément pour afficher ses relations avec d’autres éléments de la base de données. Le diagramme d’entité met en surbrillance tous les éléments liés à cet élément, et désactive le reste.

Sources de données

Les sources de données présentées dans le diagramme incluent Eventstream, stockage Azure, Azure Event Hubs et Business Events. Vous pouvez désormais voir plus de détails sur une source de données, notamment sa cartographie, son format, son statut de connectivité et le nombre d’enregistrements ingérés. Si vous n’avez plus besoin de connexion, vous pouvez la supprimer directement du diagramme d’entité.

Capture d’écran du diagramme d’entité montrant des détails supplémentaires sur une source de données.

Note

Seuls les Eventstreams, Event Hubs, stockage Azure Account et Fabric Business Events apparaissent comme sources externes dans la vue diagramme d’entité. Le diagramme d’entités n’affiche pas d’autres sources externes.

Filtrez la vue du diagramme d’entité

Filtrer par type d’entité

Utilisez le filtre déroulant Type d’entité pour sélectionner les types d’entités que vous souhaitez afficher dans le diagramme. Vous pouvez choisir parmi des tables, des fonctions, des raccourcis en vue matérialisée et des sources de données. Ce filtre vous aide à vous concentrer sur des types d’entités spécifiques, ce qui facilite l’analyse des relations et dépendances au sein de votre base de données KQL.

Capture d’écran du diagramme d’entité avec le menu déroulant du filtre du type d’entité ouvert.

Filtrer par plage de temps d’ingestion

Utilisez le filtre déroulant Ingestion pour sélectionner une plage de temps pour laquelle vous souhaitez consulter les détails d’ingestion. Ce filtre ajoute les informations d’ingestion à la carte de l’entité concernée dans le diagramme, afin que vous puissiez analyser le flux de données et les schémas d’ingestion au fil du temps.

Capture d’écran du diagramme d’entité avec le menu déroulant du filtre de plage de temps d’ingestion ouvert.

Filtrer par fonction spécifique ou table

Filtrez la vue du diagramme d’entité en sélectionnant une fonction ou une table spécifique dans le panneau de navigation de gauche. Ce filtre vous aide à vous concentrer sur une fonction ou une table particulière et ses entités associées, facilitant ainsi l’analyse des relations et dépendances au sein de votre base de données KQL.

Capture d’écran du diagramme d’entités avec une fonction ou un tableau spécifique sélectionné dans le panneau de navigation de gauche.

Violations de schéma

Les violations de schéma vous aident à identifier les incohérences ou les références rompues entre les entités de base de données. Voici quelques exemples de violations de schéma :

  • Une fonction fait référence à une table ou une colonne qui n’existe plus.
  • Une fonction fait référence à une autre fonction qui n’existe plus.
  • Une fonction fait référence à une fonction avec un nombre ou un type incorrect de paramètres.
  • Une fonction fait référence à une colonne dont le type de données a changé.
  • Une stratégie de mise à jour fait référence à une fonction ou à une table source qui n’existe plus.
  • Une stratégie de mise à jour fait référence à une fonction dont le schéma de sortie ne correspond pas au schéma de table cible.
  • Mappage d’ingestion non valide (par exemple, une ou plusieurs colonnes définies dans le mappage n’existent pas dans la table cible).
  • Une exportation continue non valide (par exemple, une table ou une colonne référencée n’a pas pu être trouvée).
  • Impossible d’atteindre une table externe, car l’emplacement de stockage n’existe peut-être pas ou il existe des autorisations insuffisantes pour y accéder.

Note

Les raccourcis sont appelés « tables externes » dans la fonctionnalité de violations de schéma.

Activer l'affichage des violations de schéma met en évidence les entités affectées directement dans le diagramme. Le fait de cliquer sur l’instance de violation de schéma ouvre un volet latéral avec des détails sur la violation.

Cette fonctionnalité vous permet de localiser et de résoudre rapidement les dépendances rompues, ce qui garantit que votre base de données Eventhouse reste cohérente et fiable.

Capture d’écran d’un diagramme d’entité montrant les violations de schéma mises en surbrillance en rouge.

Quels scénarios pouvez-vous utiliser des diagrammes d’entités pour ?

Cette section explore différents scénarios dans lesquels vous pouvez utiliser la vue diagramme d’entité dans la base de données KQL :

Gérer de manière proactive les dépendances

La gestion des dépendances entre les entités telles que les tables et les fonctions devient simple avec la traçabilité. Par exemple, si vous renommez une table ou modifiez son schéma, vous pouvez identifier instantanément les fonctions qui s’appuient sur cette table dans leur requête KQL. Cette approche proactive permet d’éviter des problèmes inattendus et garantit des mises à jour transparentes de votre structure de base de données.

Tracer les relations entre les vues matérialisées et les tables sources

Les diagrammes d’entités vous permettent de suivre les relations entre les vues matérialisées et leurs tables sources sous-jacentes. Cela simplifie l’identification des sources de données d’origine, ce qui vous permet de suivre et de dépanner plus efficacement le flux de données.

Interagir avec les éléments et agir

Vous pouvez sélectionner n’importe quel élément du graphique pour mettre en surbrillance ses éléments connexes, tandis que le reste du graphique est grisé, ce qui facilite la mise en évidence des relations spécifiques. Pour les tables et les tables externes, dans les points de suspension [...], vous pouvez sélectionner d’autres options, telles que l’interrogation de la table, la création d’un rapport Power BI basé sur la table, etc.

Capture d’écran d’une table de diagrammes d’entités montrant le menu plus.

Suivi de l'ingestion des enregistrements

Les diagrammes d'entités vous permettent de suivre combien d'enregistrements ont été ingérés dans chaque table et vue matérialisée. Cette vue claire des flux de données vous permet de maîtriser la taille et le volume des données importées, garantissant ainsi que votre base de données traite les données correctement.