Přidat popisy objektů schématu do datového agenta (náhled)

Popisy objektů schématu dávají datovému agentovi obchodní kontext ohledně tabulek, sloupců a dalších prvků ve schématu datového zdroje. Tento kontext pomáhá agentovi rozlišit mezi podobně pojmenovanými nebo nejednoznačnými objekty, pochopit účel každého objektu a generovat přesnější dotazy. Popisy jsou obzvlášť užitečné pro velká schémata, kde samotná jména objektů nevyjadřují jejich význam jasně.

Popisy objektů schématu jsou podporovány u datových zdrojů SQL, včetně lakehousů, datových skladů, databází Fabric SQL a zrcadlených databází.

Note

Popisy objektů schématu jsou momentálně ve veřejném náhledu.

Note

Popisy objektů schématu jsou k dispozici pouze tehdy, pokud váš datový agent používá preview runtime.

Přidat nebo upravit popis

Ve výchozím nastavení datový agent dědí dostupné popisy ze zdroje dat a automaticky je aktualizuje. Když upravíte zděděný popis v datovém agentu, změna se vztahuje pouze na datového agenta. Nepřepisuje popis ve zdroji a tento objekt již nedostává aktualizace popisu ze zdroje.

  1. Otevřete svého datového agenta a vyberte Nastavit.
  2. Pod datovým zdrojem vyberte popisy objektů Schema.
  3. Rozšířte schéma tak, abyste našli objekt, který chcete popsat.
  4. Vyberte ikonu Upravit vedle objektu.
  5. Zadejte popis a pak vyberte Hotovo.

Screenshot úpravy popisu tabulky v panelu popisů objektů schématu datového agenta.

Přidejte popis pomocí Python SDK

Použijte Fabric data agent Python SDK k programové správě popisů objektů schématu. Následující příklad stanovuje popis jedné tabulky v prvním datovém zdroji existujícího datového agenta:

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

Tato n-tice identifikuje prvek schématu podle jeho cesty ve zdroji dat. Pro popis sloupce přidejte jeho název do cesty k tabulce. Například použijte table_path + ("adoption_date",). Názvy cest jsou rozlišující na velikost písmen a musí odpovídat hierarchii zobrazené pro datový zdroj.

Psaní efektivních popisů

Používejte popisy k vysvětlení obchodního významu, který není zřejmý z názvu předmětu. Každý popis udržujte stručný a konkrétní.

  • U tabulek popište obchodní subjekty nebo události, které jsou zastoupeny, úroveň detailnosti tabulky a její hlavní účel.
  • U sloupců definujte obchodní význam, formát, jednotku nebo očekávané hodnoty hodnoty, pokud nemusí být jasné.
  • U ostatních prvků schématu vysvětlete jejich roli a kdy by je měl datový agent použít.
  • Upřesněte zkratky, vnitřní terminologii a podobně pojmenované objekty.
  • Zahrňte kontext, který agentovi pomůže vybrat správné objekty a vztahy při generování dotazu.

Související obsah

  • Last updated on