Connecter des vues de métriques à Power BI
Aperçu
Cette fonctionnalité est en aperçu privé. Pour l'essayer, contactez votre conseiller Databricks.
Vous pouvez publier une vue de métriques Unity Catalog dans Power BI en tant que modèle sémantique. Le modèle sémantique fait référence à la vue de métriques. Power BI query donc la vue de métriques elle-même et ne lit pas les tables de base. Les dimensions des vues de métriques deviennent des colonnes dans la table Power BI et les mesures éligibles des vues de métriques deviennent des mesures calculées Data analyse Expressions (DAX).
Configuration requise
Avant de publier une vue de métrique dans Power BI, confirmez les points suivants :
- Votre workspace est inscrit à la Preview privée et un administrateur du workspace a activé l’aperçu Publier des vues de métriques dans Power BI . Consultez Gérer les aperçus Databricks.
- Vous remplissez les conditions requises pour la publication vers le service Power BI. Voir configuration requise.
- Vous disposez d'un accès en lecture aux tables et aux schémas sources, ainsi que de l'autorisation de gérer ou d'afficher la vue métrique. Consultez la documentation sur les privilèges Unity Catalog.
- Votre vue de métriques répond aux exigences de la vue de métriques.
Configuration requise pour les vues métriques
La définition de la vue de métriques doit répondre aux exigences suivantes :
- Entrées de mesure : chaque colonne utilisée par une mesure est déclarée comme une dimension dans la section
fields. Power BI calcule les mesures à partir des colonnes de la table de modèles sémantiques, de sorte qu'une mesure qui lit une colonne non exposée comme une dimension est supprimée. Voir Pourquoi les entrées de mesure doivent être exposées en tant que dimensions. - Noms : chaque mesure et dimension possède un nom. Les mesures sans nom, autorisées par la version 1.0 de YAML, sont supprimées. Pour les règles d’attribution de noms, voir Dériver les noms de colonne à partir d’expressions.
La vue métrique suivante est prête à être publiée. Les colonnes unit_price et quantity sont toutes deux déclarées en tant que champs ; par conséquent, total_revenue peut être calculé.
version: 1.1
name: sales_metrics_mv
source: main.sales.orders
fields:
- name: unit_price
expr: unit_price
- name: quantity
expr: quantity
measures:
- name: total_revenue
expr: SUM(unit_price * quantity)
La vue métrique suivante n'est pas prête à être publiée. La mesure total_revenue lit quantity, mais quantity n'est pas déclarée dans fields, donc total_revenue est supprimée.
version: 1.1
name: sales_metrics_mv
source: main.sales.orders
fields:
- name: unit_price
expr: unit_price
measures:
- name: total_revenue
expr: SUM(unit_price * quantity)
Publier la vue métrique
Vous pouvez publier une vue de métrique une fois depuis l’Explorateur de catalogues, ou selon une planification avec une tâche Power BI dans un job. Les deux options vous demandent de choisir un mode de stockage pour le modèle sémantique :
- DirectQuery (default) : Power BI envoie des queries à la vue de métriques via Databricks SQL lorsqu’un visuel s’exécute. Les contrôles d’accès et les politiques de sécurité du Unity Catalog s’appliquent.
- Import : Power BI copie les données dans le modèle sémantique. Les contrôles d'accès et les politiques de sécurité du Unity Catalog ne s'appliquent pas aux données importées. Après la publication, effectuez un refresh du modèle sémantique dans Power BI. Jusqu'à ce que vous effectuiez un refresh, le modèle montre des valeurs vides, et les Endpoint des visuels et XML for analyse (XMLA) ne peuvent pas interroger les données.
Pour plus d’informations sur chaque mode, voir Modes de modèle sémantique dans le service Power BI.
Option 1 : publier en une seule fois depuis l’explorateur de catalogue
Suivez les étapes décrites dans Publier vers le service Power BI depuis Databricks. Sélectionnez la vue métrique, ou le schéma qui la contient, au lieu d'une table. En Mode Dataset , sélectionnez DirectQuery ou Import.
Option 2 : publier selon une planification dans un job
Utilisez cette option pour publier ou refresh le modèle sémantique dans le cadre d'un pipeline de données. Configurez une tâche Power BI comme décrit dans Tâche Power BI pour les jobs, et définissez les propriétés suivantes :
- Tables à mettre à jour : sélectionnez la vue métrique ou le schéma qui la contient.
- Mode de query Power BI : sélectionnez DirectQuery ou Import.
- Type de refresh : (Optionnel) Si vous avez choisi DirectQuery, sélectionnez Refresh de métadonnées .
Chaque fois que le Job s’exécute, la tâche Power BI publie ou refresh le modèle sémantique dans le workspace cible.
Valider le modèle sémantique
Ouvrez le modèle sémantique dans Power BI Desktop ou le service Power BI et vérifiez les éléments suivants :
- La vue de métriques apparaît comme une seule table portant le même nom que la vue de métriques, par exemple
sales_metrics_mv. - Les dimensions apparaissent sous forme de colonnes. Les dimensions des tables jointes apparaissent sous forme de colonnes dans la même table. Power BI ne crée pas de relations pour les jointures.
- Les mesures apparaissent sous la forme de mesures calculées DAX explicites, par exemple
[total_revenue].
Les champs Power BI conservent les noms des dimensions et des mesures de la vue de métriques. Si une mesure comporte une display_name dans Unity Catalog, le nom est stocké en tant qu’annotation sur le champ Power BI et n’apparaît pas dans Power BI. Les descriptions Unity Catalog, ainsi que les formats de devise et de pourcentage, sont mappés sur les propriétés de champ Power BI. Pour savoir comment définir les noms et formats d’affichage, voir Métadonnées d’agent dans les vues de métriques.
Mettre à jour le modèle sémantique
Après avoir modifié la définition de la vue de métriques, publiez à nouveau la vue de métriques sur le même modèle sémantique. La republiation met à jour les mesures DAX existantes, ajoute des mesures et des dimensions nouvellement déclarées et conserve les champs existants.
Si vous publiez avec une tâche Power BI dans un job, chaque exécution planifiée publie à nouveau la vue des métriques ; vous n'avez donc aucune autre étape à effectuer.
Pourquoi les métriques de mesure doivent être exposées en tant que dimensions
Les queries que Power BI génère à partir d’un modèle sémantique ne peuvent pas utiliser la fonction MEASURE(), donc Power BI ne peut pas demander à Databricks d’évaluer une mesure de vue de métrique directement. Au lieu de cela, lorsqu’une vue de métrique est publiée dans Power BI, chaque mesure est convertie en une expression DAX créée à partir des colonnes de dimension de la vue de métrique. Power BI envoie ensuite du SQL qui utilise ces colonnes pour recréer le résultat de la mesure.
Pour que cela fonctionne, chaque colonne lue par une mesure doit être déclarée comme dimension dans la section fields. Power BI ne fonctionne qu’avec les colonnes de la table du modèle sémantique ; une mesure qui fait référence à une colonne qui n’est pas exposée en tant que dimension ne peut donc pas être calculée et est supprimée.
Par exemple, supposons qu’une vue de métrique définit total_sales comme la somme de deux colonnes :
version: 1.1
source: main.sales.orders
fields:
- name: store_sales
expr: store_sales
- name: online_sales
expr: online_sales
measures:
- name: total_sales
expr: SUM(store_sales + online_sales)
- Query la mesure directement : Power BI devra envoyer
MEASURE(total_sales), ce qu’il ne peut pas faire. - Query la mesure convertie : La mesure est convertie en DAX qui fait référence à
store_salesetonline_sales. Power BI envoie des SQL commeSUM(store_sales + online_sales), et Databricks les évalue. - Si
online_salesn'est pas déclaré en tant que dimension : Power BI n'a aucune colonne à référencer, donctotal_salesest supprimé du modèle publié.
Modèles de vue métrique pris en charge
Les mesures éligibles des vues de métriques sont converties en DAX. Les modèles de vues de métriques suivants sont pris en charge :
- Agrégations standard :
SUM,COUNT,AVG,MIN,MAX,MEDIAN,STDDEVetVARIANCE, incluantCOUNT(*),COUNT(1),COUNT(DISTINCT x)etCOUNT_IF. - Expressions au niveau de la ligne dans un agrégat, telles que
SUM(price * qty)ouSUM(CASE ...). - Agrégats filtrés, comme
SUM(x) FILTER (WHERE p). - Ratios d’agrégats, tels que
SUM(a) / SUM(b). MEASURE(x)composition dans la même vue de métrique, y comprisMEASURE(x) FILTER (WHERE p).- Mesures de fenêtre avec une plage
current,trailing(y comprisinclusive),cumulativeouall, y compris les fenêtres qui utilisent unoffsetet les mesures dérivées des mesures de fenêtre. - Dimensions dérivées, comme
DATE_TRUNC('MONTH', source.order_date). - Dimensions des tables jointes.
- Filtres de vue, sources SQL inline et blocs
materialization. - Dimensions génériques, telles que
source.*et<join>.*.
Pour les modèles qui ne sont pas pris en charge, consultez Limites.
Limites
La publication de vues de métriques dans Power BI présente les limitations suivantes.
Certaines vues métriques n’ont pas été publiées
La publication a échoué pour les vues de métriques suivantes :
- Vues des métriques sans dimensions : Déclarez au moins une dimension dans
fields. - Vues de métriques avec plus d’une source (multi-faits) : divisez la vue de métriques en une vue de métriques par source de faits. Les vues de métriques avec une source et des jointures sont prises en charge.
- Vues de métriques partageant un nom de mesure : La publication conjointe de deux vues de métriques échoue lorsque les deux définissent une mesure portant le même nom, même si les définitions sont identiques. Les noms des mesures doivent être uniques dans un modèle sémantique Power BI. Renommez la mesure dans l’une des vues de métriques ou publiez chaque vue de métriques dans son propre modèle sémantique.
Certaines mesures et dimensions sont supprimées
Le processus de publication supprime les mesures et les dimensions qui utilisent les modèles suivants et publie le reste de la vue de métrique.
Motif | Ce qui est tombé |
|---|---|
Mesures de fenêtre de début | La mesure |
Mesures avec plusieurs spécifications de fenêtre, telles que year-to-date | La mesure |
Mesures de fenêtre dont la colonne d’ordre est combinée avec d’autres colonnes dans une dimension | La mesure |
Une mesure qui lit une colonne qui n'est pas déclarée comme une dimension, y compris les colonnes jointes telles que | La mesure |
Une colonne lue en dehors d’un agrégat, telle que | La mesure |
Champ de structure ou chemin de jointure imbriquée utilisé en tant qu’entrée de mesure | La mesure |
Nombre de lignes sur une jointure un-à-plusieurs | La mesure |
| La mesure |
Mesures construites sur une mesure supprimée | La mesure |
Mesures cycliques qui se réfèrent à elles-mêmes, directement ou par l’intermédiaire d’autres mesures | Les mesures du cycle |
| La mesure |
Mesures génériques ( | La mesure |
Mesures sans | La mesure |
Centiles ( | La mesure |
Colonnes de type struct, map, array, variant, geometry, geography et file dimension | La dimension et les mesures qui l’utilisent |
Paramètres de vue de métriques | Le parameter et les mesures qui le lisent |