Partager via


Afficher un diagramme d’entité dans la base de données KQL (préversion)

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.

Important

Cette fonctionnalité est en version préliminaire.

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.

Capture d’écran montrant une vue de diagramme d’entité dans 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.

Afficher les détails de l’ingestion

Vous pouvez également afficher les détails d’ingestion de chaque table et vue matérialisée. Pour afficher les détails de l’ingestion, sur le côté droit du ruban, sélectionnez Ingestion , puis l’intervalle de temps souhaité. Les informations sont ajoutées à la carte de l’entité concernée.

Capture d’écran d’un diagramme d’entité montrant la vue des détails de l’ingestion.

Afficher les détails de l’ingestion à partir d’Eventstreams

Vous pouvez également afficher les détails d’ingestion pour chaque table provenant d’Eventstream.

Capture d’écran d’un diagramme d’entité montrant l’ingestion à partir de la vue des détails du flux d'événements.

En plus du nom du flux d’événements, vous pouvez voir des informations supplémentaires en sélectionnant l’icône de flux vert, qui révèle le nom du flux dérivé et le nom du mappage d’ingestion. Si aucun mappage n’est affiché, le mappage par défaut (identité) est utilisé. Lorsque vous activez les détails d’ingestion sous Afficher les détails, vous verrez le nombre d’enregistrements ingérés dans chaque table de toutes les sources, y compris Eventstreams.

Capture d’écran d’un diagramme d’entité, avec les détails révélés après avoir cliqué sur l’icône verte.

Note

Seuls les flux d’événements apparaissent en tant que sources externes dans la vue diagramme d’entité. Les autres sources externes ne sont pas affichées dans le diagramme d’entité.

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.