Brug ontologi som kontekst i Fabric dataagent

Ontologi leverer styret forretningskontekst til en Fabric-dataagent. Den beskriver forretningsenheder, deres egenskaber og relationer, definitioner, synonymer, mapping og bindinger til underliggende datakilder.

Dataagenten bruger denne kontekst til at fortolke et spørgsmål og identificere en relevant underliggende datakilde. Den genererer derefter en source-native SQL-, KQL- eller DAX-forespørgsel, kører forespørgslen mod den kilde og præsenterer resultatet.

Ontologi er en kontekstkilde i denne integration. Det giver semantisk betydning, men er ikke endepunktet for forespørgselsudførelsen.

Vigtig

Denne funktion er en prøveversion.

Vigtig

For den bedste oplevelse ved brug af Ontology-kontekst, brug preview-runtime.

Hvordan ontologikontekst fungerer

Integrationen adskiller semantisk kontekst, orkestrering og forespørgselsudførelse:

  • Ontologi giver semantisk betydning. Det definerer forretningsenhederne i et domæne, deres egenskaber, hvordan de relaterer, hvilket sprog folk bruger til at beskrive dem, og hvordan de kortlægges til fysiske data.
  • Fabric data-agenten fortolker og orkestrerer. Den anvender relevant ontologikontekst på brugerens spørgsmål, vælger en underliggende kilde og genererer en passende kilde-native forespørgsel.
  • Den underliggende datakilde udfører forespørgslen. Kilden kører den genererede SQL-, KQL- eller DAX-forespørgsel under brugerens tilladelser.

For eksempel kan en flyselskabsontologi definere besætningsmedlem, flyvning, lufthavn og transportør samt relationerne mellem dem. En bruger kan stille et spørgsmål ved hjælp af disse forretningstermer uden at kende tabellerne, kolonnerne eller joins i den underliggende kilde.

Tilføj ontologi som kontekstkilde

For at tilføje ontologikontekst til en dataagent:

  1. Åbn Fabric-dataagenten.
  2. I Sources-oplevelsen vælger du Add sources.
  3. Vælg Tilføj en ontologi.
  4. Vælg den ontologi, du ønsker, at dataagenten skal bruge.
  5. Udvid Ontologien til at gennemgå dens enhedstyper og tilhørende Ontologi-datakilder.

Animeret billede, der viser, hvordan man tilføjer en ontologi som kontekstkilde til en dataagent.

Dataagenten indlæser en skrivebeskyttet repræsentation af ontologikonteksten. De tilknyttede underliggende kilder leverer de skemaer og data, som agenten kan forespørge.

Understøttede konfigurationer for underliggende kilder

De fleste semantiske konfigurationer, inklusive entitetsdefinitioner, synonymer, relationer, kortlægninger og bindinger, findes i ontologien. Du kan supplere denne styrede kontekst ved at konfigurere berettigede underliggende kilder tilknyttet ontologien.

Du skal montere en berettiget underliggende datakilde i dataagenten, før du kan tilføje konfigurationer som datakildeinstruktioner, en datakildebeskrivelse og eksempelforespørgsler. Disse dataagent-specifikke konfigurationer bruges kun af dataagenten. De er ikke forpligtet eller skrevet tilbage til Ontologien.

Animeret billede, der viser, hvordan man tilføjer konfigurationer for en underliggende ontologi-datakilde i en dataagent.

Instruktioner til datakilde

Instruktioner til datakilden giver vejledning, som dataagenten anvender, når den genererer en forespørgsel efter en specifik underliggende kilde. Brug disse instruktioner til at identificere autoritative tabeller, forklare join-stier og date-semantik, definere nødvendige filtre eller specificere kildespecifikke forretningsregler.

Hold instruktionerne fokuserede på, hvordan du forespørger kilden. For at ændre fælles forretningsdefinitioner, synonymer, entitetsrelationer, mappinger eller bindings, opdater du i stedet ontologien.

Beskrivelse af datakilde

En beskrivelse af datakilden opsummerer de data, som en underliggende kilde indeholder, og de typer spørgsmål, den kan besvare. Dataagenten bruger denne beskrivelse til at afgøre, hvornår kilden er relevant for en brugers spørgsmål.

Eksempelforespørgsler

Eksempelforespørgsler parrer et spørgsmål i naturligt sprog med den forventede kilde-native forespørgsel. Brug dem til at demonstrere forespørgselsmønstre, der kan være svære at udlede ud fra skemaet og Ontologiens kontekst alene, såsom komplekse joins, filtre, udelukkelser og aggregeringer.

Tilføj eksempler, der repræsenterer spørgsmål, som brugerne sandsynligvis vil stille, og verificer, at hver forespørgsel returnerer det forventede resultat. Dataagenten henter relevante eksempler, når den genererer en forespørgsel efter den underliggende kilde.

Understøttelse af datakildeinstruktioner, datakildebeskrivelser og eksempelforespørgsler afhænger af den underliggende kildetype. For konfigurationsunderstøttelse efter datakilde, se Tilføj og konfigurer datakilder i en Fabric-dataagent. For generel vejledning, se Konfigurér din dataagent.

Fejlfind et svar

Hvis et svar er forkert, ufuldstændigt eller fejler, gennemgå de kørte trin og downloadede Ontology-kontekst for at identificere, hvor problemet opstod.

Gennemgå løbetrinene

Kørselstrinene viser, hvordan dataagenten behandlede spørgsmålet og interagerede med den underliggende kilde.

  1. Kør spørgsmålet igen i dataagent-testoplevelsen.
  2. Åbn kør-trinene og identificer den underliggende kilde, der er valgt til spørgsmålet.
  3. Gennemgå den genererede SQL-, KQL- eller DAX-forespørgsel samt eventuelle fejl, der returneres af den underliggende kilde.
  4. Kør eller inspicer den genererede forespørgsel mod den underliggende kilde for at verificere, om den returnerer de forventede data.

Skærmbillede af kørselstrinene for et svar genereret af en dataagent, der bruger Ontology-kontekst.

Gennemgå den downloadede ontologikontekst

Den downloadede ontologikontekst er en læsbar, skrivebeskyttet repræsentation af de semantiske metadata, der er tilgængelige for dataagenten.

  1. Åbn Ontologiens fler-valg-menu, og vælg derefter Download ontologikontekst.
  2. Gennemgå den downloadede kontekst for at bekræfte, at dataagenten har modtaget de forventede enheder, egenskaber, relationer, definitioner, synonymer, mappings og bindings.
  3. Hvis den downloadede kontekst ikke afspejler de seneste ændringer i ontologien, vælg Opdater, og test derefter spørgsmålet igen.

Animeret billede, der viser, hvordan man downloader Ontologi-kontekst fra en dataagent.

Brug disse detaljer til at isolere kilden til problemet:

Hvad du observerer Hvad skal kontrolleres?
Dataagenten vælger den forkerte underliggende kilde. Bekræft, at ontologikortlægningerne og bindingerne associerer de relevante enheder med den tiltænkte kilde. Gennemgå supplerende beskrivelser og instruktioner til datakilder.
Den genererede forespørgsel bruger en uventet tabel, kolonne, egenskab eller filter. Sammenlign forespørgslen med den downloadede ontologikontekst. Verificér entitetsdefinitionerne, synonymer, relationer, mappinger og bindings i ontologien.
Den genererede forespørgsel er korrekt, men resultatet er forkert eller tomt. Kør forespørgslen mod den underliggende kilde og verificér kildedataene og dine tilladelser.
Svaret afspejler ikke en nylig opdatering af Ontologien. Opdater Ontologi-konteksten i dataagenten, og kør derefter spørgsmålet igen.
Forespørgselsudførelsen fejler. Gennemgå run-step-fejlen og valider den genererede forespørgsel mod den valgte kilde.

Du kan ikke redigere den downloadede kontekst for at ændre agentens adfærd. Foretag ændringer i Ontology-elementet, opdater dets kontekst i dataagenten, og test derefter svaret igen.

Tilladelser

Vigtig

Dataagenten udfører en genereret forespørgsel ved at bruge den anmoderende brugers tilladelser på den valgte underliggende datakilde. Brugere har brug for adgang til de relevante ontologiobjekter og de underliggende dataobjekter, der kræves for at besvare deres spørgsmål.

At dele en dataagent giver ikke adgang til dens underliggende kilder. For generel delingsvejledning, se Share a Fabric data agent.

Begrænsninger

Overvej følgende begrænsninger under forhåndsvisningen:

  • Kun berettigede underliggende kilder understøtter supplerende datakildeinstruktioner, beskrivelser og eksempelforespørgsler.
  • Power BI semantiske modeller understøtter ikke supplerende data-agent-specifik kontekst. Når du vælger en semantisk model som underliggende kilde, kan forespørgselsgenereringsprocessen muligvis ikke bruge noget ontologikontekst.
  • De dokumenterede kilde-native forespørgselssprog er SQL, KQL og DAX.
  • Dataagenten henter den nyeste Ontology-kontekst hvert 10. minut, så en ændring som at tilføje en enhed kan tage op til 10 minutter at dukke op, medmindre du manuelt opdaterer konteksten.
  • Den indledende erfaring understøtter ikke udvælgelse af enheder inden for en ontologi.

Relateret indhold

  • Sidst opdateret den