Aller au contenu principal
Page non répertoriée
Cette page n'est pas répertoriée. Les moteurs de recherche ne l'indexeront pas, et seuls les utilisateurs ayant un lien direct peuvent y accéder.

Connecter des vues de métriques à Power BI

info

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 :

Configuration requise pour les vues métriques​

La définition de la vue de métriques doit répondre aux exigences suivantes :

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é.

YAML
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.

YAML
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 :

YAML
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_sales et online_sales. Power BI envoie des SQL comme SUM(store_sales + online_sales), et Databricks les évalue.
  • Si online_sales n'est pas déclaré en tant que dimension : Power BI n'a aucune colonne à référencer, donc total_sales est 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, STDDEV et VARIANCE, incluant COUNT(*), COUNT(1), COUNT(DISTINCT x) et COUNT_IF.
  • Expressions au niveau de la ligne dans un agrégat, telles que SUM(price * qty) ou SUM(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 compris MEASURE(x) FILTER (WHERE p).
  • Mesures de fenêtre avec une plage current, trailing (y compris inclusive), cumulative ou all, y compris les fenêtres qui utilisent un offset et 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 SUM(cust.c_balance). Voir Pourquoi les entrées de mesure doivent être exposées en tant que dimensions.

La mesure

Une colonne lue en dehors d’un agrégat, telle que expr: price

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

MEASURE(x) où la source est une autre vue Indicateur

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

agg(x) utilisé comme synonyme de MEASURE(x)

La mesure

Mesures génériques (* dans measures)

La mesure

Mesures sans name

La mesure

Centiles (PERCENTILE, PERCENTILE_APPROX, PERCENTILE_CONT), fonctions définies par l’utilisateur (UDF) et fonctions géospatiales

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

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 SUM(cust.c_balance). Voir Pourquoi les entrées de mesure doivent être exposées en tant que dimensions.

La mesure

Une colonne lue en dehors d’un agrégat, telle que expr: price

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

MEASURE(x) où la source est une autre vue Indicateur

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

agg(x) utilisé comme synonyme de MEASURE(x)

La mesure

Mesures génériques (* dans measures)

La mesure

Mesures sans name

La mesure

Centiles (PERCENTILE, PERCENTILE_APPROX, PERCENTILE_CONT), fonctions définies par l’utilisateur (UDF) et fonctions géospatiales

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

Ressources supplémentaires​