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>". Der YAML-Editor wird geöffnet.

Schritt 2: Definieren von Metriken

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: 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')

  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 unter Unity Catalog-Berechtigungen und sicherungsfähige Objekte . 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 " hinzufügen.

Zum Hinzufügen mit YAML (empfohlen für die Versionssteuerung):

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'

Hinzufügen unter Verwendung der Registerkarte "Übersicht":

  • 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 ".

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(`Order 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