Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
Skemaobjektbeskrivelser giver dataagentens forretningskontekst om tabeller, kolonner og andre elementer i et datakildeskema. Denne kontekst hjælper agenten med at skelne mellem objekter med lignende navngivne eller tvetydige ting, forstå formålet med hvert objekt og generere mere præcise forespørgsler. Beskrivelser er især nyttige for store skemaer, hvor objektnavne alene ikke klart formidler deres betydning.
Skema-objektbeskrivelser understøttes for SQL-datakilder, herunder lakehouses, warehouses, Fabric SQL-databaser og spejlede databaser.
Bemærk
Beskrivelser af skemaobjekter er i øjeblikket i offentlig forhåndsvisning.
Bemærk
Skemaobjektbeskrivelser er kun tilgængelige, når din dataagent bruger preview-runtime.
Tilføj eller rediger en beskrivelse
Som standard arver dataagenten tilgængelige beskrivelser fra datakilden og opdaterer dem automatisk. Når du redigerer en arvet beskrivelse i dataagenten, gælder ændringen kun for dataagenten. Den overskriver ikke beskrivelsen i kildekoden, og det objekt modtager ikke længere beskrivelsesopdateringer fra kildekoden.
- Åbn din dataagent, og vælg derefter Opsætning.
- Under datakilden skal du vælge Skema-objektbeskrivelser.
- Udvid skemaet for at finde det objekt, du vil beskrive.
- Vælg Rediger-ikonet ved siden af objektet.
- Indtast en beskrivelse, og vælg derefter Færdig.
Tilføj en beskrivelse med Python SDK
Brug Fabric dataagenten Python SDK til at håndtere skema-objektbeskrivelser programmatisk. Følgende eksempel giver en beskrivelse for én tabel i den første datakilde for en eksisterende dataagent:
from fabric.dataagent.client import FabricDataAgentManagement
agent = FabricDataAgentManagement("<data-agent-name>")
datasource = agent.get_datasources()[0]
table_path = ("Schemas", "dbo", "Tables", "adoptions")
datasource.update_description({
table_path: "Contains one row for each pet adoption transaction."
})
Tuplen identificerer skemaelementet ved dets sti i datakilden. For at beskrive en kolonne skal dens navn tilføjes til tabellens sti. Brug f.eks. table_path + ("adoption_date",). Stinavne er små og små bogstaver og skal matche det hierarki, der vises for datakilden.
Skriv effektive beskrivelser
Brug beskrivelser til at forklare forretningsbetydning, som ikke fremgår af objektets navn. Hold hver beskrivelse kortfattet og specifik.
- For tabeller beskrives de forretningsenheder eller begivenheder, der repræsenteres, tabellens detaljeringsniveau og dens primære formål.
- For kolonner skal værdiens forretningsbetydning, format, enhed eller forventede værdier defineres, når de kan være uklare.
- For andre skemaelementer, forklar deres rolle og hvornår dataagenten skal bruge dem.
- Præcisér forkortelser, intern terminologi og lignende navne.
- Inkluder kontekst, der hjælper agenten med at vælge de korrekte objekter og relationer, når en forespørgsel genereres.