Lisää skeemaobjektin kuvaukset dataagenttiin (esikatselu)

Skeemaobjektin kuvaukset antavat tietoagentille liiketoimintakontekstin taulukoista, sarakkeista ja muista tietolähdeskeeman elementeistä. Tämä konteksti auttaa agenttia erottamaan samannimiset tai epäselvät objektit, ymmärtämään kunkin objektin tarkoituksen ja tuottamaan tarkempia kyselyjä. Kuvaukset ovat erityisen hyödyllisiä suurissa skeemoissa, joissa pelkät olioiden nimet eivät selvästi välitä niiden merkitystä.

Skeemaobjektin kuvauksia tuetaan SQL-tietolähteille, kuten järvitaloille, varastoille, Fabric SQL -tietokannoille ja peilatuille tietokannoille.

Lisää tai muokkaa kuvausta

Oletuksena dataagentti perii saatavilla olevat kuvaukset tietolähteestä ja päivittää ne automaattisesti. Kun muokkaat perityä kuvausta dataagentissa, muutos koskee vain dataagenttia. Se ei korvaa kuvauksen lähdekoodissa, eikä kyseinen olio enää saa kuvauspäivityksiä lähteestä.

1. Avaa dataagentti ja valitse sitten Setup.
2. Tietolähteestä valitse Schema object descriptions.
3. Laajenna skeemaa löytääksesi kuvattavan objektin.
4. Valitse Muokkaa-kuvake objektin vierestä.
5. Syötä kuvaus ja valitse sitten Valmis.

Lisää kuvaus Python SDK:lla

Käytä Fabric Data Agent Python SDK:ta skeemaobjektien kuvausten hallintaan ohjelmallisesti. Seuraava esimerkki esittää kuvauksen yhdelle taululle olemassa olevan dataagentin ensimmäisessä tietolähteessä:

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."
})

Tuple tunnistaa skeeman elementin sen polun perusteella tietolähteessä. Kuvataksesi sarakkea, lisää sen nimi taulukkopolkuun. Käytä esimerkiksi .table_path + ("adoption_date",) Polun nimet ovat kirjainkoon herkkiä ja niiden tulee vastata tietolähteen hierarkiaa.

Kirjoita tehokkaita kuvauksia

Käytä kuvauksia selittämään liiketoiminnan merkitystä, joka ei näy esineen nimestä. Pidä jokainen kuvaus ytimekkäänä ja täsmällisenä.

• Taulukoissa kuvaa edustettavat liiketoimintayksiköt tai tapahtumat, taulukon yksityiskohtaisuustaso ja sen ensisijainen tarkoitus.
• Sarakkeille määrittele arvon liiketoimintamerkitys, muoto, yksikkö tai odotetut arvot, kun ne saattavat olla epäselviä.
• Muiden skeemaelementtien osalta selitä niiden rooli ja milloin dataagentin tulisi niitä käyttää.
• Selvennä lyhenteitä, sisäistä terminologiaa ja samankaltaisia objekteja.
• Sisällytä konteksti, joka auttaa agenttia valitsemaan oikeat objektit ja suhteet kyselyn luomisessa.

Liittyvä sisältö

• Dataagentin konfiguraatiot
• Fabric-dataagentin ajonaikainen
• Esimerkkikyselyt
• Parhaat käytännöt dataagenttien kyselyjen generoinnin parantamiseksi