Visa ett entitetsdiagram i KQL-databasen

I Real-Time Intelligence kan du visa ursprunget och relationen mellan KQL-databasobjekt. Med vyn kan du visuellt utforska relationer mellan databasentiteter och hjälpa dig att förstå dataflödet från källan till målet, vilket ger en tydlig grafrepresentation. Med hjälp av entitetsdiagrammet kan du effektivt hantera databasen och få en djupare förståelse för hur dessa entiteter interagerar. Den här visuella representationen av entiteter förenklar databashanteringen och hjälper dig att optimera dina datastrukturer, vilket gör det enklare att spåra beroenden och vidta åtgärder snabbt.

För information om arbetsytans härkomst i Fabric, se Ursprung.

Förutsättningar

• En arbetsyta med en kapacitet aktiverad för Microsoft Fabric
• En KQL-databas med visningsbehörigheter

För användare som vill aktivera inmatningsinformationen:

• Databasadministratörs- eller databasövervakarens behörigheter för att visa inmatningsinformation i entitetsdiagrammet. Mer information finns i Rollbaserad åtkomstkontroll.

Öppna entitetsdiagramvy

För att komma åt vyn bläddrar du till önskad KQL-databas och väljer Entitetsdiagram.

Vad ser du i en vy för entitetsdiagram?

När du öppnar entitetsdiagramvyn ser du beroendena mellan alla objekt i KQL-databasen.

Entitetsdiagramvyn visar följande information:

• Tables
• Uppdatera principer
• Externa tabeller
• Genvägar
• Materialiserade vyer
• Functions
• Kontinuerlig export
• Entiteter mellan databaser
• Eventstreams

Du kan välja ett objekt för att visa dess relationer med andra objekt i databasen. Entitetsdiagrammet markerar alla objekt som är relaterade till objektet och dämpar resten.

Datakällor

Datakällorna som visas i diagrammet inkluderar Eventstream, Azure Storage, Azure Event Hubs och Business Events. Du kan nu se fler detaljer om en datakälla, inklusive dess kartläggning, dataformat, anslutningsstatus och antal inhämtade poster. Om du inte längre behöver en anslutning kan du ta bort den direkt från entitetsdiagrammet.

Filtrera vyn för entitetsdiagrammet

Filtrera efter entitetstyp

Använd rullgardinsmenyn för entitetstyper för att välja de entitetstyper du vill visa i diagrammet. Du kan välja mellan tabeller, funktioner, materialiserade vygenvägar och datakällor. Detta filter hjälper dig att fokusera på specifika entitetstyper, vilket gör det enklare att analysera relationer och beroenden i din KQL-databas.

Filtrera efter intagningstidsintervall

Använd listrutefiltret Ingestion för att välja ett tidsintervall som du vill visa information om inmatning för. Detta filter lägger till inmatningsinformationen på den relevanta enhetens kort i diagrammet, så att du kan analysera dataflöde och insamlingsmönster över tid.

Filtrera efter specifik funktion eller tabell

Filtrera entitetsdiagrammets vy genom att välja en specifik funktion eller tabell från vänster navigationspanel. Detta filter hjälper dig att fokusera på en viss funktion eller tabell och dess relaterade enheter, vilket gör det enklare att analysera relationer och beroenden i din KQL-databas.

Schemaöverträdelser

Schemaöverträdelser hjälper dig att identifiera inkonsekvenser eller brutna referenser mellan databasentiteter. Här är några exempel på schemaöverträdelser:

• En funktion refererar till en tabell eller kolumn som inte längre finns.
• En funktion refererar till en annan funktion som inte längre finns.
• En funktion refererar till en funktion med ett felaktigt antal eller en typ av parametrar.
• En funktion refererar till en kolumn vars datatyp har ändrats.
• En uppdateringsprincip refererar till en funktion eller källtabell som inte längre finns.
• En uppdateringsprincip refererar till en funktion vars utdataschema inte matchar måltabellschemat.
• Ogiltig inmatningsmappning (t.ex. en eller flera kolumner som definierats i mappningen finns inte i måltabellen).
• Ogiltig kontinuerlig export (t.ex. det gick inte att hitta en refererad tabell eller kolumn).
• Det går inte att nå en extern tabell eftersom lagringsplatsen kanske inte finns, eller så finns det inte tillräckligt med behörighet för att komma åt den.

När du aktiverar visa schemaöverträdelser markeras berörda entiteter direkt i diagrammet. Om du klickar på instansen för schemaöverträdelse öppnas en sidoruta med information om överträdelsen.

Med den här funktionen kan du snabbt hitta och lösa brutna beroenden, så att din Eventhouse-databas förblir konsekvent och tillförlitlig.

Vilka scenarier kan du använda ett entitetsdiagram för?

I det här avsnittet beskrivs olika scenarier där du kan använda entitetsdiagramvyn i KQL-databasen:

Hantera beroenden proaktivt

Att hantera beroenden mellan entiteter som tabeller och funktioner blir enkelt med härledning. Om du till exempel byter namn på en tabell eller ändrar dess schema kan du omedelbart identifiera vilka funktioner som är beroende av tabellen i deras KQL-fråga. Den här proaktiva metoden hjälper till att undvika oväntade problem och säkerställer sömlösa uppdateringar av databasstrukturen.

Spåra relationer mellan materialiserade vyer och källtabeller

Med entitetsdiagram kan du spåra relationerna mellan materialiserade vyer och deras underliggande källtabeller. Det gör det enkelt att identifiera ursprungliga datakällor så att du kan spåra och felsöka dataflödet mer effektivt.

Interagera med element och agera

Du kan välja vilket element som helst i diagrammet för att markera dess relaterade objekt, medan resten av diagrammet är nedtonat, vilket gör det lättare att fokusera på specifika relationer. För tabeller och externa tabeller kan du i ellipsen [...] välja andra alternativ, till exempel att fråga tabellen, skapa en Power BI-rapport baserat på tabellen med mera.

Insamling av spårloggar

Med entitetsdiagram kan du spåra hur många poster som matades in i varje tabell och materialiserad vy. Den här tydliga vyn över dataflöden hjälper dig att hålla koll på inmatningsstorleken och volymen, vilket säkerställer att databasen bearbetar data korrekt.

Relaterat innehåll

• Ursprung för arbetsyta