Metrik görünümlerinde aracı meta verileri

Aracı meta verileri (anlam meta verileri olarak da bilinir) veri görselleştirmesini geliştirir ve ölçümlerinize iş bağlamı sağlayan görünen adlar, biçim belirtimleri ve eş anlamlılar sağlayarak büyük dil modeli (LLM) doğruluğunu geliştirir. Bu meta veriler, görselleştirme araçlarının ve Genie Agents gibi doğal dil araçlarının verilerinizi daha etkili bir şekilde yorumlamasına ve bunlarla çalışmasına yardımcı olur.

Note

Databricks Runtime 17.3 ve YAML sürüm 1.1 gerektirir. Bkz. sürüm gereksinimleri.

Aracı meta verileri nedir?

Meta agent verileri, görünen adları, biçim belirtimlerini ve ek bağlam sağlayan eş anlamlıları içerir. Bu meta veriler, yapay zeka/BI panoları gibi görselleştirme araçlarının yanı sıra Genie Aracıları gibi doğal dil araçlarının verilerinizi daha etkili bir şekilde yorumlamasına ve bunlarla çalışmasına yardımcı olur. Aracı meta verileri metrik görünümünün YAML tanımında tanımlanır.

Note

Belirtim sürümü 1.1 ile ölçüm görünümleri oluşturduğunuzda veya değiştirdiğinizde, tanım kaydedildiğinde YAML tanımındaki tüm tek satırlı açıklamalar (ile #belirtilir) kaldırılır. Mevcut YAML tanımlarını yükseltirken seçenekler ve öneriler için bkz. YAML 1.1'e yükseltme.

Bu sayfadaki örneklerdesamples.tpch.orders veri kümelerinde varsayılan olarak kullanılabilen TPC-H örnek veri kümesi () kullanılır. TPC-H veri kümesi siparişler, müşteriler, tedarikçiler ve parçalar için tablolar içeren bir toptan tedarik zinciri modeller. Tablodaki orders sütun adları önekini o_ kullanır (örneğin, o_orderdate sipariş tarihi için, o_totalprice toplam fiyat için). TPC-H şeması ve veri modeli hakkında ayrıntılı bilgi için bkz . Öğretici: Birleştirmeler ve veri modelleme ile ölçüm görünümü oluşturma.

Görünen adlar

Görünen adlar, insan tarafından okunabilir etiketler sağlayarak, teknik sütun adları yerine görselleştirme araçlarında görünür. Görünen adlar 255 karakterle sınırlıdır.

Aşağıdaki örnek, order_date alanı (siparişlerin ne zaman verildiğini izleyen) ve total_revenue ölçüsü (tüm sipariş fiyatlarının toplamını hesaplayan) üzerinde tanımlanan görünen adları göstermektedir.

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

Eş anlamlılar , Genie gibi LLM araçlarının alternatif adlar sağlayarak kullanıcı girişi aracılığıyla alanları (boyutlar olarak da adlandırılır) ve ölçüleri keşfetmesine yardımcı olur. Blok stili veya akış stili YAML kullanarak eş anlamlılar tanımlayabilirsiniz. Her alan veya ölçünün en fazla 10 eş anlamlısı olabilir. Her eş anlamlı 255 karakterle sınırlıdır.

Aşağıdaki örnekte, alanda tanımlanan order_date eş anlamlılar (siparişler verildiğinde) ve total_revenue ölçü (tüm sipariş fiyatlarının toplamı) gösterilmektedir. Eş anlamlılar, kullanıcıların "sipariş zamanına göre gelir göster" veya "sipariş tarihine göre toplam satışlar nelerdir" gibi doğal bir dil kullanarak sorular sormasına olanak sağlar:

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']

Biçim belirtimleri

Biçim belirtimleri, görselleştirme araçlarında değerlerin nasıl görüntülenmesi gerektiğini tanımlar. Aşağıdaki tablolar desteklenen biçim türlerini ve örneklerini içerir.

Sayısal biçimler

Biçim Türü	Gerekli Seçenekler	İsteğe Bağlı Seçenekler
Sayı: İsteğe bağlı ondalık basamak denetimi ve kısaltma seçenekleriyle genel sayısal değerler için düz sayı biçimini kullanın.	type: number	decimal_places: Ondalık noktadan sonra gösterilen basamak sayısını kontrol eder. type: (Belirtilirse decimal_places gereklidir) max exact all places: 0-10 arası tamsayı değeri (tür max veya exactise gereklidir) hide_group_separator: true olarak ayarlandığında, gibi ,geçerli bir sayı gruplandırma ayırıcısını kaldırır. true false abbreviation: none compact scientific
Para birimi: ISO-4217 para birimi kodlarıyla parasal değerler için para birimi biçimini kullanın.	type: currency	currency_code: ISO-4217 kodu (gerekli). Örneğin, aşağıdaki kodlar sırasıyla ABD doları, Euro ve Yen sembolünü ekler. USD EUR JPY decimal_places: Ondalık noktadan sonra gösterilen basamak sayısını kontrol eder. type: (Belirtilirse decimal_places gereklidir) max exact all hide_group_separator: True olarak ayarlandığında, ilgili sayı gruplandırma ayırıcısını kaldırır. true false abbreviation: none compact scientific
Yüzde: Yüzde olarak ifade edilen oran değerleri için yüzde biçimini kullanın.	type: percentage	decimal_places: Ondalık noktadan sonra gösterilen basamak sayısını kontrol eder. type: (Belirtilirse decimal_places gereklidir) max exact all hide_group_separator: True olarak ayarlandığında, ilgili sayı gruplandırma ayırıcısını kaldırır. true false
Bayt: Uygun bayt birimleriyle (KB, MB, GB vb.) görüntülenen veri boyutu değerleri için bayt biçimini kullanın.	type: byte	decimal_places: Ondalık noktadan sonra gösterilen basamak sayısını kontrol eder. type: (Belirtilirse decimal_places gereklidir) max exact all places: 0-10 arası tamsayı değeri (tür max veya exactise gereklidir) hide_group_separator: True olarak ayarlandığında, ilgili sayı gruplandırma ayırıcısını kaldırır. true false

Sayısal biçimlendirme örnekleri

Sayı

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

Para birimi

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

Yüzde

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

Bayt (byte)

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

Tarih ve saat biçimleri

Aşağıdaki tabloda tarih ve saat biçimleriyle çalışma açıklanmaktadır.

Biçim Türü	Gerekli Seçenekler	İsteğe Bağlı Seçenekler
Tarih: Çeşitli görüntüleme seçenekleriyle tarih değerleri için tarih biçimini kullanın.	type: date date_format: Tarihin görüntülenme şeklini denetler locale_short_month: Ay adı kısaltılmış olarak tarihi görüntüler locale_long_month: Tarihi ayın tam adıyla gösterir year_month_day: Tarihi YYYY-MM-DD olarak biçimlendir locale_number_month: Tarihi sıralı olarak ayı sayı şeklinde görüntüler year_week: Tarihi yıl ve hafta numarası olarak biçimlendirır. Örneğin, 2025-W1	leading_zeros: Tek basamaklı sayıların önünde sıfır olup olmadığını denetler true false
DateTime: Tarih ve saati birleştiren zaman damgası değerleri için tarih saat biçimini kullanın.	type: date_time date_format: Tarihin görüntülenme şeklini denetler no_date: Tarih gizli locale_short_month: Ay adı kısaltılmış olarak tarihi görüntüler locale_long_month: Tarihi ayın tam adıyla gösterir year_month_day: Tarihi YYYY-MM-DD olarak biçimlendir locale_number_month: Tarihi sıralı olarak ayı sayı şeklinde görüntüler year_week: Tarihi yıl ve hafta numarası olarak biçimlendirır. Örneğin, 2025-W1 time_format: no_time: Zaman gizli locale_hour_minute: Saati ve dakikayı görüntüler locale_hour_minute_second: Saati, dakikayı ve saniyeyi görüntüler	leading_zeros: Tek basamaklı sayıların önünde sıfır olup olmadığını denetler true false

Note

Bir date_time türüyle çalışırken, date_format veya time_format en az bir değer olarak no_date veya no_time dışında bir değer belirtmelidir.

Tarih saat biçimlendirme örnekleri

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

Aşağı yönlü araçlar entegrasyonu

Anlam meta verileri, ölçüm görünümünü kullanan aşağı akış araçlarını otomatik olarak doldurur:

• AI/BI panoları: Görünen adlar ve biçim belirtimleri, panonun okunabilirliğini artırmak için pano veri kümelerinde ve görselleştirmelerde otomatik olarak doldurulur.
• Genie Aracıları: Genie'nin ölçüm görünümündeki kullanılabilir alanları ve ölçüleri daha iyi keşfetmesine ve anlamasına yardımcı olmak için eş anlamlılar otomatik olarak içeri aktarılır.

Tam örnek

Aşağıdaki örnekte, satış performansını izleyen ve tüm aracı meta veri türlerini içeren bir ölçüm görünümü tanımı gösterilmektedir. Ölçüm görünümü gelir ölçümlerini hesaplamak, müşterileri sipariş değerine göre segmentlere ayırmak ve sipariş hacimlerini izlemek için sipariş verilerini analiz eder.

Müşteri segmentleri aşağıdaki gibi tanımlanır:

• Kurumsal: 100.000 ABD dolarının üzerindeki siparişler
• Orta pazar: 10.000 ILE 100.000 ABD doları arasındaki siparişler
• Küçük ve orta ölçekli işletmeler: 10.000 ABD dolarının altındaki siparişler

Meta veriler "müşteri segmentlerine göre toplam satışları göster" veya "sipariş başına ortalama gelir nedir" gibi doğal dil sorgularını destekler.

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