Freigeben über

Erstellen einer Metrikansicht mithilfe der Benutzeroberfläche des Katalog-Explorers

In diesem Artikel erfahren Sie, wie Sie eine Metrikansicht erstellen, um Geschäftslogik zu zentralisieren und wichtige Leistungsindikatoren über Berichtsoberflächen hinweg konsistent zu definieren. In diesem Lernprogramm wird das Erstellen einer Metrikansicht mithilfe der Katalog-Explorer-Benutzeroberfläche veranschaulicht. Informationen zum Definieren von Metrikansichten mit SQL finden Sie unter Verwenden von SQL zum Erstellen und Verwalten von Metrikansichten und CREATE VIEW.

Voraussetzungen

  • Sie müssen über Berechtigungen für die Quelldatenobjekte verfügen SELECT .
  • Sie müssen über die CREATE TABLE Berechtigungen und die USE SCHEMA Berechtigungen im Schema verfügen, in dem Sie die Metrikansicht erstellen möchten.
  • Sie müssen außerdem über die Berechtigung USE CATALOG für den übergeordneten Katalog des Schemas verfügen.
  • Verwendungsberechtigungen auf einem SQL-Warehouse oder einer anderen Rechenressource, die Databricks Runtime 17.2 oder höher ausführt.

Ein Metastoreadministrator oder der Katalogbesitzer kann Ihnen all diese Berechtigungen gewähren. Ein Schemabesitzer oder Benutzer mit den MANAGE Berechtigungen kann Ihnen USE SCHEMA und CREATE TABLE Berechtigungen für das Schema gewähren.

Schritt 1: Auswählen einer Datenquelle

Ihre Metrikansicht kann auf einer Tabelle, Ansicht oder SQL-Abfrage basieren. Dieses Tutorial verwendet die Tabelle orders im Schema samples des Katalogs tpch.

  1. Klicken Sie auf das Symbol Katalog in der Arbeitsbereich-Randleiste.
  2. Verwenden Sie die Suchleiste im Schemabrowser, um die samples.tpch.orders Tabelle zu finden. Klicken Sie auf "Bestellungen ", um Tabellendetails anzuzeigen.
  3. Klicken Sie auf "Metrische Ansicht erstellen>".
  4. Geben Sie einen Namen ein, oder lassen Sie den Namen als orders_metric_view.
  5. Wählen Sie einen Katalog und ein Schema aus, für das Sie über Berechtigungen verfügen.

Erstellen Sie die Metrikansicht mithilfe der Benutzeroberfläche.

Schritt 2: Definieren von Metriken

Benutzeroberfläche (öffentliche Vorschau)

  1. Klicken Sie auf "Filtern ", um einen Filter auf Zeilenebene hinzuzufügen. Wählen Sie source.o_orderdate als Spalte, größer als als Operator, und geben Sie 1990-01-01 als Wert ein und klicken Sie auf "Schließen".

  2. Klicken Sie auf die Registerkarte " Dimensionen ".

    • Klicken Sie auf O Orderdate: Geben Sie Order Month als Anzeigenamen ein. Klicken Sie im Feld „Ausdruck“ auf „Benutzerdefiniert“ und geben Sie DATE_TRUNC('MONTH', o_orderdate) ein.

    • Klicken Sie auf "O Orderstatus": Geben Sie Order Status als Anzeigename ein. Klicken Sie auf "Benutzerdefiniert" , und geben Sie den folgenden Ausdruck ein:

      CASE
  WHEN o_orderstatus = 'O' THEN 'Open'
  WHEN o_orderstatus = 'P' THEN 'Processing'
  WHEN o_orderstatus = 'F' THEN 'Fulfilled'
END

    • Klicken Sie auf O Bestellpriorität: Bestellpriorität: Geben Sie Order Priority als Namen ein. Klicken Sie auf Benutzerdefiniert und geben Sie SPLIT(o_orderpriority, '-')[1] ein.

    • Entfernen Sie die anderen Dimensionen, indem Sie sie auswählen und auf "Löschen" klicken.

  3. Klicken Sie auf die Registerkarte "Measures ".

    • Klicken Sie Count: Order Count: Geben Sie Order Count als Anzeigenamen ein. Klicken Sie auf Benutzerdefiniert und geben Sie COUNT(1) ein.

    • Klicken Sie für jede zusätzliche Maßnahme auf +Hinzufügen.

      • Gesamtumsatz: Geben Sie Total Revenue als Namen ein. Klicken Sie unter "Ausdruck" auf "Builder" und wählen Sie das Feld source.o_totalprice aus, und unter "Berechnen" wählen Sie "SUMME" aus.

        Fügen Sie ein Maß in der Metrik-Ansicht der Benutzeroberfläche hinzu.

      • Gesamtumsatz pro Kunde: Geben Sie Total Revenue per Customer als Namen ein. Klicken Sie auf Benutzerdefiniert und geben Sie SUM(o_totalprice) / COUNT(DISTINCT o_custkey) ein.

      • Gesamtumsatz für offene Bestellungen: Geben Sie Total Revenue for Open Orders als Namen ein. Klicken Sie auf Benutzerdefiniert und geben Sie SUM(o_totalprice) FILTER (WHERE o_orderstatus='O') ein.

      Um eine Vorschau einer Maßnahme anzuzeigen, klicken Sie neben dem Maßnahmennamen auf das Symbol Play IconVorschau. In der Vorschau werden die Messergebnisse für ein ausgewähltes Fenster und eine Zeitdimension angezeigt. Die folgende Vorschau zeigt z. B. den Gesamtumsatz mithilfe des Fensters 'Aktuelles' über Bestellmonat an.

      Zeigen Sie eine Vorschau einer Maßnahme in der Metrikansicht der Benutzeroberfläche an.

  4. Klicken Sie auf die Registerkarte "Vorschau ".

  5. Klicken Sie auf "Speichern".

Ihre Metrikansicht kann von jedem Benutzer mit mindestens SELECT minimalen Rechten für die Metrikansicht verwendet werden. Weitere Informationen zum Verwalten von Berechtigungen finden Sie im Unity-Katalog-Berechtigungen-Referenz. Weitere Informationen dazu, wie Benutzer diese Metrikansicht abfragen können, finden Sie unter Abfrage einer Metrikansicht.

Vorschauauftragsmetrikansicht

Nachdem Sie eine Metrikansicht erstellt haben, können Sie die Quelle, Filter sowie die angegebenen Messwerte und Dimensionen auf der Seite Übersicht überprüfen.

YAML

Die YAML-Definition für diese Metrikansicht enthält die folgenden Felder auf oberster Ebene:

  • version: Standardmäßig auf 1.1. Dies ist die Version der Spezifikation für die Metrikansicht.
  • source:samples.tpch.orders ist ein vollqualifizierter Tabellenname. Alle Dimensionen und Maße in dieser Metrikansicht verwenden die angegebene Tabelle als Datenquelle.
  • filter: Alle Abfragen in dieser Ansicht geben Datensätze mit einem o_orderdate nach dem 1. Januar 1990 zurück.
  • dimensions:Order Month, Order Status, und Order Priority sind als Dimensionen definiert.
  • measures: Vier Maßnahmen (Order Count, Total Revenue, Total Revenue per Customer, und Total Revenue for Open Orders) werden definiert, jeweils mit einem angegebenen Aggregationsausdruck.

  1. Verwenden Sie das Dropdownmenü "Katalog" und "Schema", um auszuwählen, wo Die Metrikansicht gespeichert werden soll. Benutzer, die Abfragen durchführen, müssen über mindestens USE CATALOG und USE SCHEMA Berechtigungen verfügen, um auf die Metrikansicht zuzugreifen.

  2. Geben Sie einen Namen für die Metrikansicht ein. Metrische Ansichtsnamen können alphanumerische Werte und Unterstriche enthalten.

  3. Ersetzen Sie den Inhalt des Editors durch die folgende Definition:

    version: 1.1

source: samples.tpch.orders

filter: source.o_orderdate > '1990-01-01'

dimensions:
  - name: Order Status
    expr: |-
      CASE
        WHEN o_orderstatus = 'O' THEN 'Open'
        WHEN o_orderstatus = 'P' THEN 'Processing'
        WHEN o_orderstatus = 'F' THEN 'Fulfilled'
      END
    display_name: Order Status
  - name: Order Month
    expr: "DATE_TRUNC('MONTH', o_orderdate)"
    display_name: Order Month
  - name: o_orderpriority
    expr: "SPLIT(o_orderpriority, '-')[1]"
    display_name: Order priority

measures:
  - name: count
    expr: COUNT(1)
    display_name: Order Count
  - name: Total Revenue
    expr: SUM(source.o_totalprice)
    display_name: Total Revenue
  - name: Total Revenue per Customer
    expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
    display_name: Total Revenue Per Customer
  - name: Total Revenue for Open Orders
    expr: SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')
    display_name: Total Revenue For Open Orders

  4. Klicken Sie auf "Erstellen".

Ihre Metrikansicht kann von jedem Benutzer mit mindestens SELECT minimalen Rechten für die Metrikansicht verwendet werden. Weitere Informationen zum Verwalten von Berechtigungen finden Sie im Unity-Katalog-Berechtigungsreferenz. Weitere Informationen dazu, wie Benutzer diese Metrikansicht abfragen können, finden Sie unter Abfrage einer Metrikansicht.

Nachdem Sie eine Metrikansicht erstellt haben, können Sie die Quell-, Filter- und angegebenen Maße und Dimensionen auf der anschließend geöffneten Registerkarte "Übersicht" überprüfen.

Schritt 3: Hinzufügen einer Beschreibung, Kommentare und Tags

Sie können Beschreibungen, Kommentare und Tags entweder in der YAML-Definition oder über die Registerkarte "Übersicht " im Katalog-Explorer hinzufügen.

Katalog-Explorer

  • Klicken Sie im Katalog-Explorer auf Ihre Metrikansicht.
  • Klicken Sie auf "Beschreibung hinzufügen ", um der Metadaten der Metrikansicht eine Beschreibung hinzuzufügen.
  • Um Kommentare hinzuzufügen, fahren Sie mit der Maus über die Spalte "Kommentar" in der Reihe, in der Sie einen Kommentar hinzufügen möchten.
  • Wenn Sie einem Maß oder einer Dimension Tags hinzufügen möchten, bewegen Sie die Maus über die Spalte Tags, in der Sie ein Tag hinzufügen möchten.
  • Wenn Sie der Metrikansicht ein Tag hinzufügen möchten, klicken Sie auf der rechten Seite der Seite auf "Tags hinzufügen ".

YAML

Fügen Sie comment Felder direkt in Ihrer YAML-Definition hinzu. Details zur Syntax finden Sie im Änderungsprotokoll zur Versionsspezifikation .

version: 1.1
comment: 'Orders metrics for revenue analysis'

dimensions:
  - name: Order Month
    expr: DATE_TRUNC('MONTH', o_orderdate)
    comment: 'Month when the order was placed'

measures:
  - name: Total Revenue
    expr: SUM(o_totalprice)
    comment: 'Sum of all order prices'

Schritt 4: (Optional) Bearbeiten der YAML-Definition

Sie können die YAML-Definition anzeigen und den YAML-Editor über die Registerkarte "Details " öffnen.

  1. Klicken Sie auf Details.
  2. Klicken ... weitere Zeilen, um die vollständige Definition anzuzeigen.
  3. Klicken Sie auf "Bearbeiten ", um den YAML-Editor zu öffnen.
  4. Hinzufügen oder Löschen von Dimensionen oder Kennzahlen. Klicken Sie auf "Speichern".

Schritt 5: (Optional) Berechtigungen festlegen

Metrikansichten respektieren das gleiche hierarchische Berechtigungsmodell wie andere sicherungsfähige Unity Catalog-Objekte. Es sind keine neuen Berechtigungen erforderlich, wenn Ihre Metrikansicht in einem Schema gespeichert ist, auf das die beabsichtigten Verbraucher Lesezugriff haben. Sie können auf der Registerkarte "Berechtigungen " explizit Berechtigungen für die Metrikansicht zuweisen.

  1. Klicken Sie auf Berechtigungen.
  2. Verwenden Sie die Benutzeroberfläche, um Berechtigungen für andere Azure Databricks-Benutzer zu erteilen und zu widerrufen.

Weitere Informationen finden Sie unter Erteilen von Berechtigungen für ein Objekt.

Abfragen einer Metrik-Ansicht

Sie können eine Metrikansicht aus dem integrierten SQL-Editor des Arbeitsbereichs oder einem beliebigen SQL-Editor abfragen, der auf Ihre Daten in Azure Databricks zugreifen kann. Um eine Metrikansicht abzufragen, müssen Sie an ein SQL Warehouse oder eine andere Computeressource angefügt werden, die Databricks Runtime 17.2 oder höher ausführt.

Die folgende Beispielabfrage bewertet die drei aufgelisteten Maßnahmen und aggregiert über Order Month und Order Status. Sie erhalten die Ergebnisse sortiert nach Order Month.

Alle Maßnahmen müssen in der MEASURE Funktion eingeschlossen werden. Siehe measure Aggregatfunktion.


SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC

Nächste Schritte

Nachdem Sie nun eine Metrikansicht mit SQL erstellt haben, erkunden Sie die folgenden verwandten Themen:

Abfragen und Verwenden von Metrikansichten

Erweiterte Funktionen der Metrikansicht

Alternative Erstellungsmethoden

Governance und Sicherheit

  • Last updated on