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 TABLEetUSE SCHEMAsur le schéma où vous créez la vue de métrique, etUSE CATALOGsur son catalogue. Pour créer le schéma gold, vous avez également besoin deCREATE SCHEMAsurstarterjourney_catalog.SELECTsurbakehouse_silver.transactionsetbakehouse_silver.franchises.CAN USEsur un SQL Warehouse, comme Starter Warehouse , ou sur un compute exécutant Databricks Runtime 18.1 et une version ultérieure.
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 :
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 :
- Dans l’explorateur de catalogues, ouvrez le schéma
bakehouse_goldet cliquez sur Créer > Vue métrique . - Dans la boîte de dialogue Create metric view , saisissez le nom
franchise_sales_metrics, sélectionnez le cataloguestarterjourney_cataloget le schémabakehouse_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 :
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.franchisessurfranchise_id, plusieurs à un. - Les champs sont
franchise,sales_date(au niveau du jour) etproduct. - Les mesures sont
total_salesen tant queSUM(total_price),order_counten tant queCOUNT(1)etavg_order_valueen tant queMEASURE(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.
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 *.
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
-
- Générer et partager le tableau de bord de la performance des franchises
- Générer le tableau de bord de performance de la franchise Bakehouse sur cette vue métrique
-
- Référence de la syntaxe YAML pour les vues de métriques
- Rechercher chaque clé YAML pour les vues métriques, y compris les jointures,
rely, les synonymes et la matérialisation