Udostępnij przez

Tworzenie widoków metryk i zarządzanie nimi przy użyciu języka SQL

Na tej stronie wyjaśniono, jak tworzyć widoki metryk i zarządzać nimi przy użyciu języka SQL.

Wymagania wstępne

  • Musisz mieć SELECT uprawnienia do obiektów danych źródłowych.
  • Musisz mieć CREATE TABLE uprawnienia i USE SCHEMA uprawnienia w schemacie, w którym chcesz utworzyć widok metryk.
  • Musisz również mieć USE CATALOG uprawnienia do katalogu nadrzędnego schematu.
  • MOŻE UŻYWAĆ uprawnień do usługi SQL Warehouse lub innego zasobu obliczeniowego z uruchomionym środowiskiem Databricks Runtime 17.2 lub nowszym.

Administrator magazynu metadanych lub właściciel wykazu może przyznać Ci wszystkie te uprawnienia. Właściciel schematu lub użytkownik z uprawnieniami MANAGE może udzielić Ci uprawnień USE SCHEMA i CREATE TABLE w schemacie.

Utwórz widok metryk

Użyj CREATE VIEW z klauzulą WITH METRICS, aby utworzyć widok metryki. Widok metryki musi być zdefiniowany z prawidłową specyfikacją YAML w treści. Dane źródłowe widoku metryki mogą być tabelą, widokiem lub zapytaniem SQL.

Dane źródłowe dla następującego widoku metryk to samples.tpch.orders tabela dostępna w wykazie przykładów dla większości wdrożeń usługi Azure Databricks. Poniższy kod SQL DDL tworzy widok metryki o nazwie orders_metric_view w bieżącym wykazie i schemacie. Aby określić inny katalog i schemat, użyj trzypoziomowej przestrzeni nazw Unity Catalog.

Do definicji widoku metryki można dodawać komentarze na poziomie tabeli i na poziomie kolumny.

CREATE OR REPLACE VIEW orders_metric_view
WITH METRICS
LANGUAGE YAML
AS $$
  version: 1.1
  comment: "Orders KPIs for sales and financial analysis"
  source: samples.tpch.orders
  filter: o_orderdate > '1990-01-01'
  dimensions:
    - name: Order Month
      expr: DATE_TRUNC('MONTH', o_orderdate)
    - name: Order Status
      expr: CASE
        WHEN o_orderstatus = 'O' then 'Open'
        WHEN o_orderstatus = 'P' then 'Processing'
        WHEN o_orderstatus = 'F' then 'Fulfilled'
        END
    - name: Order Priority
      expr: SPLIT(o_orderpriority, '-')[1]
  measures:
    - name: Order Count
      expr: COUNT(1)
    - name: Total Revenue
      expr: SUM(o_totalprice)
    - name: Total Revenue per Customer
      expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
    - name: Total Revenue for Open Orders
      expr: SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')
$$

Zmień widok metryki

Aby wprowadzić zmiany w definicji skojarzonej z widokiem metryki, użyj polecenia ALTER VIEW. Poniższy przykład dodaje komentarze do wymiarów i miar w orders_metric_view widoku metrycznym.

ALTER VIEW orders_metric_view
AS $$
  version: 1.1
  comment: "Orders KPIs for sales and financial analysis"
  source: samples.tpch.orders
  filter: o_orderdate > '1990-01-01'
  dimensions:
    - name: Order Month
      expr: DATE_TRUNC('MONTH', o_orderdate)
      comment: "Month of order"
    - name: Order Status
      expr: CASE
        WHEN o_orderstatus = 'O' then 'Open'
        WHEN o_orderstatus = 'P' then 'Processing'
        WHEN o_orderstatus = 'F' then 'Fulfilled'
        END
      comment: "Status of order: open, processing, or fulfilled"
    - name: Order Priority
      expr: SPLIT(o_orderpriority, '-')[1]
      comment: "Numeric priority 1 through 5; 1 is highest"
  measures:
    - name: Order Count
      expr: COUNT(1)
    - name: Total Revenue
      expr: SUM(o_totalprice)
      comment: "Sum of total price"
    - name: Total Revenue per Customer
      expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
      comment: "Sum of total price by customer"
    - name: Total Revenue for Open Orders
      expr: SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')
      comment: "Potential revenue from open orders"
$$

Udzielanie uprawnień w widoku metryki

Widok metryki jest zabezpieczalnym obiektem katalogu Unity i stosuje ten sam model uprawnień co inne widoki. Uprawnienia są hierarchiczne, więc uprawnienia do magazynu metadanych, katalogu lub schematu są przekazywane na obiekty zawarte w tych strukturach. Poniższy przykład zapewnia minimalne uprawnienia niezbędne dla użytkowników w data_consumers grupie do wykonywania zapytań dotyczących widoku metryki.

GRANT SELECT ON orders_metric_view to `data-consumers`;

Aby dowiedzieć się więcej o uprawnieniach w Unity Catalog, zobacz Zarządzanie uprawnieniami w Unity Catalog. Aby dowiedzieć się więcej na temat tworzenia grup i zarządzania nimi, zobacz Grupy.

Uzyskaj definicję widoku metryki

Użyj DESCRIBE TABLE EXTENDED z opcjonalnym AS JSON parametrem, aby wyświetlić definicję widoku metryki. Parametr AS JSON jest opcjonalny. Pominięcie tego zapewnia wynik, który jest lepszy dla ludzkich czytelników, podczas gdy uwzględnienie go jest korzystniejsze dla algorytmów maszynowych. Poniższy przykład zwraca ciąg JSON opisujący widok metryki i jego składniki.

DESCRIBE TABLE EXTENDED orders_metric_view AS JSON

Usuń widok metryki

Aby usunąć widok metryki, użyj składni DROP VIEW.

DROP VIEW orders_metric_view;

Dalsze kroki

Po utworzeniu widoku metryki przy użyciu języka SQL zapoznaj się z następującymi tematami pokrewnymi:

Wykonywanie zapytań i korzystanie z widoków metryk

Zaawansowane funkcje widoku metryk

Alternatywne metody tworzenia

Ład i bezpieczeństwo

  • Last updated on