Ügynök metaadatai metrikanézetekben

Az ügynök metaadatai (más néven szemantikai metaadatok) javítja az adatvizualizációt, és javítja a nagy nyelvi modell (LLM) pontosságát azáltal, hogy megjelenítendő neveket, formátum-specifikációkat és szinonimákat biztosít, amelyek üzleti környezetet biztosítanak a metrikáknak. Ezek a metaadatok segítik az adatvizualizációs eszközöket és a természetesnyelv-feldolgozó eszközöket, például a Genie Agents eszközt, abban, hogy hatékonyabban értelmezzék az adatait, és dolgozzanak velük.

Note

A Databricks Runtime 17.3 és a YAML 1.1-es verziója szükséges. Lásd a verzióra vonatkozó követelményeket.

Mi az ügynök metaadatai?

Az ügynök metaadatai közé tartoznak a megjelenítendő nevek, a formátumspecifikációk és a további kontextust biztosító szinonimák. Ezek a metaadatok segítik a vizualizációs eszközöket, például az AI-/BI-irányítópultokat, valamint a természetes nyelvfeldolgozó eszközöket, például a Genie Agents megoldást, abban, hogy hatékonyabban értelmezzék és kezeljék az adatait. Az ügynök metaadatait a metrikanézet YAML-definíciója határozza meg.

Note

Ha metrikanézeteket hoz létre vagy módosít az 1.1-es specifikációs verzióval, a YAML-definícióban szereplő egysoros megjegyzések (a következővel #jelölve) törlődnek a definíció mentésekor. A meglévő YAML-definíciók frissítésével kapcsolatos lehetőségeket és javaslatokat a YAML 1.1-es verziójára való frissítéssel kapcsolatban talál.

Az ezen a lapon szereplő példák a TPC-H mintaadatkészletet (samples.tpch.orders) használják, amely alapértelmezés szerint elérhető a Unity Catalog-adathalmazokban. A TPC-H adatkészlet egy nagykereskedelmi ellátási láncot modellez megrendelések, ügyfelek, szállítók és alkatrészek tábláival. A táblázatban szereplő orders oszlopnevek az o_ előtagot használják (például o_orderdate a rendelési dátumhoz, o_totalprice a teljes árhoz). A TPC-H sémával és adatmodellel kapcsolatos részletekért tekintse meg az oktatóanyagot: Metrikanézet létrehozása illesztésekkel és adatmodellezéssel.

Nevek megjelenítése

A megjelenített nevek a technikai oszlopnevek helyett a vizualizációs eszközökben megjelenő, olvasható feliratokat biztosítanak. A megjelenített nevek legfeljebb 255 karakter hosszúságúak.

Az alábbi példa a mezőben definiált megjelenítendő neveket (a order_date rendelések leadásának nyomon követését) és total_revenue a mértéket (az összes rendelési ár összegének kiszámítását) mutatja be.

version: 1.1
source: samples.tpch.orders

fields:
  - name: order_date
    expr: o_orderdate
    display_name: 'Order Date'

measures:
  - name: total_revenue
    expr: SUM(o_totalprice)
    display_name: 'Total Revenue'

Synonyms

A szinonimák segítenek az LLM-eszközöknek, például a Genie-nek, a mezők felderítésének (más néven dimenzióknak) és a mértékeknek a felhasználói bemeneten keresztül, alternatív nevek megadásával. A szinonimákat blokkstílus vagy folyamatstílus YAML használatával definiálhatja. Minden mező vagy mérték legfeljebb 10 szinonimát tartalmazhat. Az egyes szinonimák legfeljebb 255 karakter hosszúságúak.

Az alábbi példa a order_date mezőben definiált szinonimákat (a rendelések leadásakor) és total_revenue a mértéket (az összes rendelési ár összegét) mutatja be. A szinonimák lehetővé teszik a felhasználók számára, hogy természetes nyelven tegyenek fel kérdéseket, például a "bevétel megjelenítése rendelési idő szerint" vagy "mi a teljes értékesítés a megrendelés dátuma szerint":

version: 1.1
source: samples.tpch.orders

fields:
  - name: order_date
    expr: o_orderdate
    # block style
    synonyms:
      - 'order time'
      - 'date of order'

measures:
  - name: total_revenue
    expr: SUM(o_totalprice)
    # flow style
    synonyms: ['revenue', 'total sales']

Formátumspecifikációk

A formátumspecifikációk határozzák meg, hogyan jelenjenek meg az értékek a vizualizációs eszközökben. Az alábbi táblázatok támogatott formátumtípusokat és példákat tartalmaznak.

Numerikus formátumok

Formátum típusa	Kötelező beállítások	Választható beállítások
Szám: Egyszerű számformátum használata az általános numerikus értékekhez választható tizedesjegy-vezérlőelemmel és rövidítési beállításokkal.	type: number	decimal_places: A tizedesjegy után megjelenő helyek számát szabályozza. type: (Kötelező, ha decimal_places meg van adva) max exact all places: 0 és 10 közötti egész szám (típus max esetén exactkötelező) hide_group_separator: Ha igaz értékre van állítva, eltávolítja a megfelelő számcsoport-elválasztót, például a ,. true false abbreviation: none compact scientific
Pénznem: Pénznemformátum használata az ISO-4217 pénznemkódokkal rendelkező pénzügyi értékekhez.	type: currency	currency_code: ISO-4217-kód (kötelező). A következő kódok például beszúrják az USA dollár, euró és jen szimbólumát. USD EUR JPY decimal_places: A tizedesjegy után megjelenő helyek számát szabályozza. type: (Kötelező, ha decimal_places meg van adva) max exact all hide_group_separator: Ha igaz értékre van állítva, eltávolítja a megfelelő számcsoport-elválasztót. true false abbreviation: none compact scientific
Százalék: Százalékformátum használata százalékban kifejezett arányértékekhez.	type: percentage	decimal_places: A tizedesjegy után megjelenő helyek számát szabályozza. type: (Kötelező, ha decimal_places meg van adva) max exact all hide_group_separator: Ha igaz értékre van állítva, eltávolítja a megfelelő számcsoport-elválasztót. true false
Bájt: A megfelelő bájtegységekkel (KB, MB, GB stb.) megjelenített adatméretértékekhez használjon bájtformátumot.	type: byte	decimal_places: A tizedesjegy után megjelenő helyek számát szabályozza. type: (Kötelező, ha decimal_places meg van adva) max exact all places: 0 és 10 közötti egész szám (típus max esetén exactkötelező) hide_group_separator: Ha igaz értékre van állítva, eltávolítja a megfelelő számcsoport-elválasztót. true false

Numerikus formázási példák

Szám

format:
  type: number
  decimal_places:
    type: max
    places: 2
  hide_group_separator: false
  abbreviation: compact

Valuta

format:
  type: currency
  currency_code: USD
  decimal_places:
    type: exact
    places: 2
  hide_group_separator: false
  abbreviation: compact

Százalék

format:
  type: percentage
  decimal_places:
    type: all
  hide_group_separator: true

Bájt

format:
  type: byte
  decimal_places:
    type: max
    places: 2
  hide_group_separator: false

Dátum- és időformátumok

Az alábbi táblázat a dátum- és időformátumok használatát ismerteti.

Formátum típusa	Kötelező beállítások	Választható beállítások
Dátum: Dátumformátum használata különböző megjelenítési beállításokkal rendelkező dátumértékekhez.	type: date date_format: A dátum megjelenítésének módját szabályozza locale_short_month: Megjeleníti a dátumot egy rövidített hónappal locale_long_month: Megjeleníti a dátumot a hónap teljes nevével year_month_day: A dátumot így formázza: YYYY-MM-DD locale_number_month: Számként jeleníti meg a hónapot tartalmazó dátumot year_week: A dátumot egy év és egy hét számként formázja. Például: 2025-W1	leading_zeros: Azt szabályozza, hogy az egyjegyű számokat nulla előzi-e meg true false
DateTime: Dátum/idő formátum használata dátumot és időt kombináló időbélyeg-értékekhez.	type: date_time date_format: A dátum megjelenítésének módját szabályozza no_date: A dátum rejtett locale_short_month: Megjeleníti a dátumot egy rövidített hónappal locale_long_month: Megjeleníti a dátumot a hónap teljes nevével year_month_day: A dátumot így formázza: YYYY-MM-DD locale_number_month: Számként jeleníti meg a hónapot tartalmazó dátumot year_week: A dátumot egy év és egy hét számként formázja. Például: 2025-W1 time_format: no_time: Az idő rejtve van locale_hour_minute: Az óra és a perc megjelenítése locale_hour_minute_second: Az óra, a perc és a másodperc megjelenítése	leading_zeros: Azt szabályozza, hogy az egyjegyű számokat nulla előzi-e meg true false

Note

Ha date_time típussal dolgozik, legalább az egyiknek date_format vagy time_format értéket kell megadnia, amely eltér no_date és no_time-tól.

Dátum/idő formázási példák

Date

format:
  type: date
  date_format: year_month_day
  leading_zeros: true

DateTime

format:
  type: date_time
  date_format: year_month_day
  time_format: locale_hour_minute_second
  leading_zeros: false

Alsóbb rétegbeli eszközök integrációja

A szemantikai metaadatok automatikusan feltöltik a metrikanézetet használó alsóbb rétegbeli eszközöket:

• AI/BI-irányítópultok: A megjelenítendő nevek és formátumspecifikációk automatikusan ki lesznek töltve irányítópult-adathalmazokban és vizualizációkban az irányítópult olvashatóságának javítása érdekében.
• Genie-ügynökök: A rendszer automatikusan importálja a szinonimákat, hogy a genie jobban felderítse és megértse a metrikanézetből elérhető mezőket és mértékeket.

Teljes példa

Az alábbi példa egy metrikanézet-definíciót mutat be, amely nyomon követi az értékesítési teljesítményt, és tartalmazza az összes ügynök metaadattípusát. A metrikanézet elemzi a rendelési adatokat a bevételi metrikák kiszámításához, az ügyfelek rendelési érték szerinti szegmentálásához és a rendelésmennyiségek nyomon követéséhez.

Az ügyfélszegmensek a következőképpen vannak definiálva:

• Nagyvállalat: 100 000 USD feletti rendelések
• Középpiac: 10 000 és 100 000 ft közötti megrendelések
• Kis- és középvállalkozások: 10 000 usd alatti megrendelések

A metaadatok olyan természetes nyelvi lekérdezéseket támogatnak, mint a "teljes értékesítés megjelenítése ügyfélszegmens szerint" vagy "mi az átlagos bevétel rendelésenként".

version: 1.1
source: samples.tpch.orders
comment: Comprehensive sales metrics with enhanced semantic metadata
fields:
  - name: order_date
    expr: o_orderdate
    comment: Date when the order was placed
    display_name: Order Date
    format:
      type: date
      date_format: year_month_day
      leading_zeros: true
    synonyms:
      - order time
      - date of order
  - name: customer_segment
    expr: |
      CASE
        WHEN o_totalprice > 100000 THEN 'Enterprise'
        WHEN o_totalprice > 10000 THEN 'Mid-market'
        ELSE 'SMB'
      END
    comment: Customer classification based on order value
    display_name: Customer Segment
    synonyms:
      - segment
      - customer tier
measures:
  - name: total_revenue
    expr: SUM(o_totalprice)
    comment: Total revenue from all orders
    display_name: Total Revenue
    format:
      type: currency
      currency_code: USD
      decimal_places:
        type: exact
        places: 2
      hide_group_separator: false
      abbreviation: compact
    synonyms:
      - revenue
      - total sales
      - sales amount
  - name: order_count
    expr: COUNT(1)
    comment: Total number of orders
    display_name: Order Count
    format:
      type: number
      decimal_places:
        type: all
      hide_group_separator: true
    synonyms:
      - count
      - number of orders
  - name: avg_order_value
    expr: SUM(o_totalprice) / COUNT(1)
    comment: Average revenue per order
    display_name: Average Order Value
    format:
      type: currency
      currency_code: USD
      decimal_places:
        type: exact
        places: 2
    synonyms:
      - aov
      - average revenue