Aller au contenu principal

Définir les métriques des ventes en tant que vue de métriques

La page query et explorer vos données compute le revenu quotidien de la franchise avec une query enregistrée. Une vue de métrique transforme cette logique en un objet géré. Vous définissez le Total des ventes, le Nombre de commandes et la Valeur moyenne des commandes au même endroit, et les tableaux de bord, les agents Genie et les clients SQL lisent la même définition. Modifiez une mesure dans cette définition, et les queries qui s'exécutent après la modification l'utilisent.

La source est votre couche silver. La sortie est starterjourney_catalog.bakehouse_gold.franchise_sales_metrics.

Configuration requise​

Vous avez besoin de ce qui suit avant de créer la vue des métriques :

  • CREATE TABLE et USE SCHEMA sur le schéma où vous créez la vue de métrique, et USE CATALOG sur son catalogue. Pour créer le schéma gold, vous avez également besoin de CREATE SCHEMA sur starterjourney_catalog.
  • SELECT sur bakehouse_silver.transactions et bakehouse_silver.franchises.
  • CAN USE sur un SQL Warehouse, comme Starter Warehouse , ou sur un compute exécutant Databricks Runtime 18.1 et une version ultérieure.
remarque

Vous pouvez créer une vue métrique sur Databricks Runtime 16.4 et versions supérieures. Les exemples de cette page nécessitent la version 18.1 et supérieures, car le YAML définit rely.at_most_one_match sur la jointure. Les synonymes et les commentaires sur les champs et les mesures nécessitent également la spécification YAML 1.1. Les SQL Warehouse répondent aux deux exigences.

Créer la vue des métriques​

Créez le schéma Gold, définissez la vue des métriques avec Genie Code ou le YAML de fallback, puis vérifiez ses totaux par rapport à la query enregistrée.

Créer le schéma gold​

Dans l'éditeur SQL, attachez un SQL warehouse, tel que Starter Warehouse , et exécutez :

SQL
CREATE SCHEMA IF NOT EXISTS starterjourney_catalog.bakehouse_gold;

Créer la vue métrique​

Créez une vue de métrique vide dans le schéma bakehouse_gold, puis ouvrez-la dans l'éditeur :

  1. Dans l’explorateur de catalogues, ouvrez le schéma bakehouse_gold et cliquez sur Créer > Vue métrique .
  2. Dans la boîte de dialogue Create metric view , saisissez le nom franchise_sales_metrics, sélectionnez le catalogue starterjourney_catalog et le schéma bakehouse_gold, puis cliquez sur Create .

Générer la définition avec Genie Code​

Dans l’éditeur, ouvrez Genie Code à partir de l’icône dans le coin supérieur droit et collez ce prompt :

prompt

Tell Genie Code to do this for you:

Create a metric view on starterjourney_catalog.bakehouse_silver.transactions joined to starterjourney_catalog.bakehouse_silver.franchises on franchise_id, many-to-one. Add fields: franchise (the franchise_name from the join), sales_date (the transaction_timestamp truncated to a day), and product. Add measures: total_sales as SUM(total_price), order_count as COUNT(1), and avg_order_value as total_sales divided by order_count. Add the synonyms "revenue" and "sales" to total_sales, and "AOV" to avg_order_value.

Passer en revue la définition​

Vérifiez la définition générée par rapport à cette liste :

  • La source est bakehouse_silver.transactions, jointe à bakehouse_silver.franchises sur franchise_id, plusieurs à un.
  • Les champs sont franchise, sales_date (au niveau du jour) et product.
  • Les mesures sont total_sales en tant que SUM(total_price), order_count en tant que COUNT(1) et avg_order_value en tant que MEASURE(total_sales) / MEASURE(order_count).

Les noms des champs et des mesures sont importants. Le tableau de bord et les pages de l’agent Genie Agent y font référence ; renommez donc tout nom généré qui diffère de la liste ci-dessus.

Use the fallback YAML

Open the YAML editor with the <> button, replace the definition with the following, and then continue.

YAML
version: 1.1
comment: 'Franchise sales KPIs for the Bakehouse journey'
source: starterjourney_catalog.bakehouse_silver.transactions
joins:
- name: franchise_dim
source: starterjourney_catalog.bakehouse_silver.franchises
'on': source.franchise_id = franchise_dim.franchise_id
rely:
at_most_one_match: true
fields:
- name: franchise
expr: franchise_dim.franchise_name
comment: 'Franchise name'
- name: sales_date
expr: DATE(source.transaction_timestamp)
comment: 'Calendar day of the transaction'
- name: product
expr: source.product
comment: 'Product sold'
measures:
- name: total_sales
expr: SUM(source.total_price)
comment: 'Sum of transaction total price'
synonyms: ['revenue', 'sales']
- name: order_count
expr: COUNT(1)
comment: 'Number of transactions'
- name: avg_order_value
expr: MEASURE(total_sales) / MEASURE(order_count)
comment: 'Average order value'
synonyms: ['AOV']

Prévisualiser et enregistrer​

Cliquez sur Preview (Prévisualiser) pour vérifier les champs et les mesures, puis cliquez sur Save (Enregistrer).

Valider par rapport à la query enregistrée​

Dans l’éditeur SQL, exécutez cette query. Enveloppez chaque mesure dans MEASURE() et listez chaque colonne au lieu d’utiliser SELECT *.

SQL
SELECT
`sales_date`,
`franchise`,
MEASURE(`total_sales`) AS total_sales
FROM starterjourney_catalog.bakehouse_gold.franchise_sales_metrics
GROUP BY ALL
ORDER BY `sales_date`, `franchise`;

Les totaux quotidiens par franchise doivent correspondre à la query de revenus quotidiens par franchise que vous avez enregistrée. Voir Enregistrer la query. Si ce n’est pas le cas, vérifiez la jointure et les mesures.

Certifier et transférer​

Une fois les numéros correspondants, appliquez la balise gérée par le système system.certification_status avec la valeur certified à la vue des métriques. Vous avez besoin de l’autorisation ASSIGN sur cette balise. Voir Marquer des données comme certifiées ou dépréciées.

Seul le propriétaire peut modifier la définition d’une vue de métrique. Pour qu’une équipe puisse la maintenir, accordez au groupe SELECT sur les tables sources, puis transférez la propriété de la vue de métrique au groupe. Chaque membre du groupe peut ensuite modifier la définition. Databricks ne prend pas en charge le transfert de propriété pour les vues de métriques matérialisées. Voir Activer la modification collaborative.

Dépannage​

Utilisez ces entrées pour dépanner la boîte de dialogue de création, les totaux, les noms de champ et la fonction MEASURE().

La création de la vue métrique échoue ou l’option n’est pas disponible

Attachez un SQL warehouse, ou un compute exécutant Databricks Runtime 18.1 ou une version ultérieure, et confirmez que vous disposez de CAN USE dessus.

Les totaux semblent gonflés

La cardinalité de jointure par default est many_to_one, qui traite la table jointe comme une recherche de dimension. Les totaux augmentent lorsque vous définissez rely.at_most_one_match: true sur une jointure de franchise qui comporte plus d’une ligne par franchise_id. Databricks ne valide pas le paramètre rely au moment de l’exécution, de sorte que les correspondances en double font renvoyer des résultats erronés à SUM et COUNT. Confirmez que la jointure de franchise est de type plusieurs-à-un sur franchise_id et que franchises comporte une ligne par franchise.

Genie Code utilisait des noms de champ différents

Les pages du tableau de bord et de l’agent Genie Agent utilisent franchise, sales_date, product, total_sales, order_count et avg_order_value. Renommez les champs et les mesures générés pour qu’ils correspondent, ou collez le YAML fallback.

Les totaux journaliers ne correspondent pas à la query enregistrée

Vérifiez que sales_date tronque transaction_timestamp en un jour et que total_sales additionne total_price. Réconcilier toute différence de fuseau horaire entre les deux queries.

Une query échoue avec une erreur concernant la fonction MEASURE

Enveloppez chaque mesure dans MEASURE() et transmettez le name de la mesure, pas son nom d'affichage. Si le nom contient des espaces, enveloppez-le dans des backticks, par exemple MEASURE(`Total Revenue`). Consultez Vues de métrique de query.

Étapes suivantes​