Partager via

Créer une vue de métrique à l’aide de l’interface utilisateur de l’Explorateur de catalogues

Découvrez comment créer une vue de métrique pour centraliser la logique métier et définir de manière cohérente des indicateurs de performances clés sur les surfaces de création de rapports. Ce tutoriel montre comment créer une vue de métrique à l’aide de l’interface utilisateur de l’Explorateur de catalogues. Pour définir des vues de métriques à l’aide de SQL, consultez Utiliser SQL pour créer et gérer des vues de métriques et CREATE VIEW.

Prerequisites

  • Vous devez disposer SELECT de privilèges sur les objets de données sources.
  • Vous devez disposer du CREATE TABLE privilège et du USE SCHEMA privilège dans le schéma dans lequel vous souhaitez créer l’affichage des métriques.
  • Vous devez également disposer du privilège USE CATALOG sur le catalogue parent du schéma.
  • PEUT UTILISER des autorisations sur un entrepôt SQL ou une autre ressource de calcul exécutant Databricks Runtime 17.2 ou version ultérieure.

Un administrateur de metastore ou le propriétaire du catalogue peut vous octroyer tous ces privilèges. Un propriétaire de schéma ou un utilisateur disposant du privilège MANAGE peut vous accorder USE SCHEMA et CREATE TABLE privilèges sur le schéma.

Étape 1 : Choisir une source de données

Votre vue de métrique peut être basée sur une table, une vue ou une requête SQL. Ce tutoriel utilise la table orders dans le schéma samples du catalogue tpch.

  1. Cliquez sur l’icône Données.Catalogue dans la barre latérale de l’espace de travail.
  2. Utilisez la barre de recherche dans le navigateur de schéma pour rechercher la samples.tpch.orders table. Cliquez sur Commandes pour afficher les détails du tableau.
  3. Cliquez sur Créer un>affichage métrique. L’éditeur YAML s’ouvre.

Étape 2 : Définir des métriques

La définition YAML pour cette vue de métrique comprend les champs de niveau supérieur suivants :

  • version : La valeur par défaut est 1.1. Il s’agit de la version de la spécification de la vue métrique.
  • source:samples.tpch.orders est un nom de table pleinement qualifié. Toutes les dimensions et mesures de cette vue métrique utilisent la table spécifiée comme source de données.
  • filter: Toutes les requêtes sur cette vue retournent des enregistrements avec un o_orderdate après le 1er janvier 1990.
  • dimensions:Order Month, Order Statuset Order Priority sont définis en tant que dimensions.
  • measures: quatre mesures (Order Count, Total Revenue, Total Revenue per Customeret Total Revenue for Open Orders) sont définies, chacune avec une expression d’agrégation spécifiée.

  1. Utilisez le menu déroulant catalogue et schéma pour choisir l’emplacement où vous souhaitez enregistrer votre vue métrique. Les utilisateurs doivent avoir au moins les privilèges USE CATALOG et USE SCHEMA pour accéder à la vue de métrique.

  2. Entrez un nom pour votre vue métrique. Les noms d’affichage des métriques peuvent inclure des valeurs alphanumériques et des traits de soulignement.

  3. Remplacez le contenu de l’éditeur par la définition suivante :

    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. Cliquez sur Créer.

Votre vue de métrique est prête à être consommée par n’importe quel utilisateur disposant d’au moins SELECT de privilèges sur la vue de métrique. Consultez les privilèges du catalogue Unity et les objets sécurisables pour en savoir plus sur la gestion des autorisations. Pour en savoir plus sur la façon dont les utilisateurs peuvent interroger cette vue de métrique, consultez Interroger une vue de métrique.

Après avoir créé une vue de métrique, vous pouvez passer en revue la source, le filtre et les dimensions spécifiés dans l’onglet Vue d’ensemble qui s’ouvre.

Étape 3 : Ajouter une description, des commentaires et des balises

Vous pouvez ajouter des descriptions, des commentaires et des balises dans la définition YAML ou dans l’onglet Vue d’ensemble .

Pour ajouter à l’aide de YAML (recommandé pour le contrôle de version) :

Ajoutez des champs comment directement dans votre définition YAML. Pour plus d’informations sur la syntaxe, consultez le journal des modifications de spécification de version .

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'

Pour ajouter à l’aide de l’onglet Vue d’ensemble :

  • Cliquez sur Ajouter une description pour ajouter une description aux métadonnées de l’affichage des métriques.
  • Pour ajouter des commentaires, pointez sur la colonne Commentaire de la ligne dans laquelle vous souhaitez ajouter un commentaire.
  • Pour ajouter des balises à une mesure ou une dimension, pointez sur la colonne Balises où vous souhaitez ajouter une balise.
  • Pour ajouter une balise à l’affichage des métriques, cliquez sur Ajouter des balises sur le côté droit de la page.

Étape 4 : (facultatif) Modifier la définition YAML

Vous pouvez afficher la définition YAML et ouvrir l’éditeur YAML à partir de l’onglet Détails .

  1. Cliquez sur Details.
  2. Cliquez sur ... plus de lignes pour afficher la définition complète.
  3. Cliquez sur Modifier pour ouvrir l’éditeur YAML.
  4. Ajoutez ou supprimez des dimensions ou des mesures. Cliquez sur Enregistrer.

Étape 5 : (Facultatif) Définir des autorisations

Les vues de métriques respectent le même modèle d’autorisations hiérarchiques que les autres objets sécurisables du catalogue Unity. Aucune nouvelle autorisation n’est nécessaire si votre vue des métriques est stockée dans un schéma auquel les utilisateurs désignés ont accès de lecture. Vous pouvez attribuer explicitement des autorisations sur l’affichage des métriques à partir de l’onglet Autorisations .

  1. Cliquez sur Autorisations.
  2. Utilisez l’interface utilisateur pour accorder et révoquer des autorisations pour d’autres utilisateurs Azure Databricks.

Pour plus d’informations, consultez Accorder des autorisations sur un objet.

Interroger une vue de métriques

Vous pouvez interroger une vue de métrique à partir de l’éditeur SQL intégré de l’espace de travail ou de n’importe quel éditeur SQL pouvant accéder à vos données sur Azure Databricks. Pour interroger une vue de métrique, vous devez être attaché à un entrepôt SQL ou à une autre ressource de calcul exécutant Databricks Runtime 17.2 ou version ultérieure.

L’exemple de requête suivant évalue les trois mesures et agrégats répertoriés sur Order Month et Order Status. Elle retourne les résultats triés par Order Month.

Toutes les mesures doivent être encapsulées dans la MEASURE fonction. Voir measure la fonction d’agrégation.


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

Étapes suivantes

Maintenant que vous avez créé une vue de métrique à l’aide de SQL, explorez ces rubriques connexes :

Interroger et utiliser des vues de métriques

Fonctionnalités avancées d’affichage des métriques

Autres méthodes de création

Gouvernance et sécurité

  • Last updated on