Visualizza un diagramma di entità nel database KQL

In Real-Time Intelligence è possibile visualizzare la derivazione e la relazione degli elementi del database KQL. La vista consente di esplorare visivamente le relazioni tra le entità di database e di comprendere il flusso di dati dall'origine alla destinazione, fornendo una rappresentazione chiara del grafico. Usando il diagramma di entità, è possibile gestire in modo efficiente il database e acquisire una conoscenza più approfondita del modo in cui queste entità interagiscono. Questa rappresentazione visiva delle entità semplifica la gestione dei database e consente di ottimizzare le strutture di dati, semplificando il rilevamento delle dipendenze e l'esecuzione rapida delle azioni.

Per informazioni sulla lineage dell'area di lavoro in Fabric, vedere Lineage.

Prerequisiti

Per gli utenti che vogliono attivare i dettagli di acquisizione:

  • Autorizzazioni di Amministratore del Database o di Monitor del Database per visualizzare i dettagli di inserimento nel diagramma di entità. Per altre informazioni, vedere Controllo degli accessi in base al ruolo.

Aprire la visualizzazione diagramma entità

Per accedere alla visualizzazione, passare al database KQL desiderato e selezionare Diagramma entità.

Screenshot che mostra il pulsante di visualizzazione del diagramma delle entità.

Cosa viene visualizzato in una visualizzazione diagramma di entità?

Quando si apre la visualizzazione diagramma di entità, vengono visualizzate le dipendenze tra tutti gli elementi nel database KQL.

Nella visualizzazione diagramma entità vengono visualizzate le informazioni seguenti:

È possibile selezionare un elemento per visualizzarne le relazioni con altri elementi nel database. Il diagramma di entità evidenzia tutti gli elementi correlati a tale elemento e riduce il resto.

Origini dati

Le fonti dati mostrate nel diagramma includono Eventstream, Archiviazione di Azure, Hub eventi di Azure e Business Events. Ora puoi vedere più dettagli su una fonte dati, inclusa la sua mappatura, il formato dei dati, lo stato della connettività e il numero di record ingeriti. Se non hai più bisogno di una connessione, puoi cancellarla direttamente dal diagramma delle entità.

Screenshot del diagramma dell'entità che mostra dettagli aggiuntivi su una fonte di dati.

Annotazioni

Solo Eventstreams, Event Hubs, Archiviazione di Azure Account e Fabric Business Events appaiono come sorgenti esterne nella vista diagramma dell'entità. Il diagramma di entità non mostra altre fonti esterne.

Filtra la vista del diagramma di entità

Filtra per tipo di entità

Usa il filtro a discesa Tipo di entità per selezionare i tipi di entità che desideri visualizzare nel diagramma. Puoi scegliere tra tabelle, funzioni, scorciatoie per la visualizzazione materializzata e fonti dati. Questo filtro ti aiuta a concentrarti su tipi specifici di entità, rendendo più facile analizzare relazioni e dipendenze all'interno del tuo database KQL.

Screenshot del diagramma di entità con il menu a tendina del filtro per il tipo di entità aperto.

Filtra per intervallo di tempo di ingestione

Usa il filtro a tendina Ingestion per selezionare un intervallo temporale per il quale vuoi visualizzare i dettagli dell'ingestione. Questo filtro aggiunge le informazioni di ingestione alla scheda dell'entità rilevante nel diagramma, così puoi analizzare i flussi di dati e i modelli di ingestione nel tempo.

Schermata del diagramma delle entità con il menu a discesa del filtro per l'intervallo di tempo di acquisizione aperto.

Filtra per funzione o tabella specifica

Filtra la vista del diagramma di entità selezionando una funzione o una tabella specifica dal pannello di navigazione sinistro. Questo filtro ti aiuta a concentrarti su una particolare funzione o tabella e sulle sue entità correlate, rendendo più facile analizzare relazioni e dipendenze all'interno del tuo database KQL.

Screenshot del diagramma delle entità con una funzione o tabella specifica selezionata dal pannello di navigazione a sinistra.

Violazioni dello schema

Le violazioni dello schema consentono di identificare incoerenze o riferimenti interrotti tra entità di database. Ecco alcuni esempi di violazioni dello schema:

  • Una funzione fa riferimento a una tabella o a una colonna che non esiste più.
  • Una funzione fa riferimento a un'altra funzione che non esiste più.
  • Una funzione fa riferimento a una funzione con un numero o un tipo di parametri non corretti.
  • Una funzione fa riferimento a una colonna il cui tipo di dati è stato modificato.
  • Un criterio di aggiornamento fa riferimento a una funzione o a una tabella di origine che non esiste più.
  • Un criterio di aggiornamento fa riferimento a una funzione il cui schema di output non corrisponde allo schema della tabella di destinazione.
  • Mapping di inserimento non valido( ad esempio una o più colonne definite nel mapping non esistono nella tabella di destinazione).
  • Esportazione continua non valida(ad esempio non è stato possibile trovare una tabella o una colonna a cui si fa riferimento).
  • Non è possibile raggiungere una tabella esterna perché il percorso di archiviazione potrebbe non esistere o non sono disponibili autorizzazioni sufficienti per accedervi.

Annotazioni

Le scorciatoie vengono definite "tabelle esterne" nella funzionalità relativa alle violazioni dello schema.

L'abilitazione di Mostra le violazioni dello schema evidenzia le entità interessate direttamente nel diagramma. Facendo clic sull'istanza di violazione dello schema si apre un riquadro laterale con i dettagli sulla violazione.

Questa funzionalità consente di individuare e risolvere rapidamente le dipendenze interrotte, assicurando che il database eventhouse rimanga coerente e affidabile.

Screenshot di un diagramma di entità che mostra le violazioni dello schema evidenziate in rosso.

Quali scenari è possibile usare diagrammi di entità per?

Questa sezione illustra vari scenari in cui è possibile usare la vista diagramma entità nel database KQL:

Gestire in modo proattivo le dipendenze

La gestione delle dipendenze tra entità come tabelle e funzioni diventa semplice con la derivazione. Ad esempio, se si rinomina una tabella o ne si modifica lo schema, è possibile identificare immediatamente le funzioni che si basano su tale tabella all'interno della query KQL. Questo approccio proattivo consente di evitare problemi imprevisti e garantisce aggiornamenti semplici alla struttura del database.

Relazioni di traccia tra viste materializzate e tabelle di origine

I diagrammi di entità consentono di tracciare le relazioni tra le viste materializzate e le relative tabelle di origine sottostanti. Ciò semplifica l'identificazione delle origini dati originali, consentendo di tenere traccia e risolvere i problemi del flusso di dati in modo più efficace.

Interagire con elementi e agire

È possibile selezionare qualsiasi elemento nel grafico per evidenziare gli elementi correlati, mentre il resto del grafico è disattivato, rendendo più semplice concentrarsi su relazioni specifiche. Per le tabelle e le tabelle esterne, nei puntini di sospensione [...], è possibile selezionare altre opzioni, ad esempio l'esecuzione di query sulla tabella, la creazione di un report di Power BI in base alla tabella e altro ancora.

Screenshot di un diagramma di entità che mostra il menu opzioni.

Tenere traccia dell'inserimento di record

I diagrammi di entità consentono di tenere traccia del numero di record inseriti in ogni tabella e vista materializzata. Questa chiara visualizzazione dei flussi di dati consente di rimanere al di sopra delle dimensioni e del volume di inserimento, garantendo che i dati del database vengano elaborati correttamente.