Vues des métriques de requêtes.

Vous pouvez interroger des vues de métriques telles que des vues standard à partir de n’importe quel éditeur SQL attaché à un entrepôt SQL ou à une ressource de calcul exécutant un runtime pris en charge. Les vues de métriques permettent un regroupement et un filtrage flexibles. Vous pouvez analyser des mesures sur n’importe quelle combinaison de champs (également appelés dimensions) au moment de l’exécution sans pré-calculer chaque agrégation. Les requêtes de cette page illustrent des modèles de requête courants.

Mesures et champs de requête

Toutes les évaluations de mesure dans une requête d’affichage des métriques doivent utiliser la fonction d’agrégation MEASURE . Pour obtenir des détails et une syntaxe complets, consultez measure la fonction d’agrégation. Dans Databricks Runtime 18.1 et versions ultérieures, vous pouvez également utiliser agg.

Note

Pour sélectionner tous les champs et mesures d’une vue de métrique, répertoriez explicitement chaque champ et encapsulez chaque mesure avec la fonction d’agrégation MEASURE() . Étant donné que les mesures exigent que la MEASURE() fonction évalue correctement, vous devez spécifier des colonnes individuelles plutôt que d’utiliser SELECT *.

Requête avec regroupement

SELECT
  `Order Month`,
  `Order Status`,
  MEASURE(`Order Count`),
  MEASURE(`Total Revenue`)
FROM orders_metric_view
GROUP BY ALL
ORDER BY `Order Month`;

Requête avec filtrage

SELECT
  o_orderpriority,
  MEASURE(`Total Revenue`),
  MEASURE(`Total Revenue per Customer`)
FROM orders_metric_view
WHERE `Order Status` = 'Fulfilled'
GROUP BY o_orderpriority;

Interroger avec d’autres tables

Les vues de métriques ne peuvent pas être jointes directement avec d’autres tables au moment de la requête. Pour joindre une vue de métrique à une autre table, encapsulez la requête d’affichage des métriques dans un CTE, puis joignez le résultat CTE :

WITH orders AS (
  SELECT
    o_custkey,
    MEASURE(`Order Count`) AS order_count,
    MEASURE(`Total Revenue`) AS total_revenue
  FROM orders_metric_view
  GROUP BY o_custkey
)
SELECT
  c.c_mktsegment,
  orders.order_count,
  orders.total_revenue
FROM orders
JOIN samples.tpch.customer c ON orders.o_custkey = c.c_custkey
ORDER BY c.c_mktsegment;

Interroger une vue de métriques avec des paramètres

Pour interroger une vue de métrique qui définit des paramètres, appelez-la en tant que fonction table et transmettez chaque paramètre en tant qu’argument nommé. Pour plus d’informations et d’exemples, consultez Interroger une vue de métrique avec des paramètres.

Afficher la définition et les métadonnées de l’affichage des métriques

La requête suivante retourne la définition YAML complète pour une vue de métrique, y compris les mesures, les champs, les jointures et les métadonnées de l’agent. Le paramètre AS JSON est facultatif. Pour obtenir des détails complets sur la syntaxe, consultez la sortie au format JSON.

DESCRIBE TABLE EXTENDED <catalog.schema.metric_view_name> AS JSON

La définition YAML complète est affichée dans le champ Afficher le texte dans les résultats. Chaque colonne contient un champ de métadonnées qui contient les métadonnées de l’agent.

Utiliser des vues de métriques dans les outils

Vous pouvez également utiliser des vues de métriques dans l’espace de travail Azure Databricks et dans des outils externes :

Tool Description
tableaux de bord IA/BI Utilisez des vues de métriques pour fournir des analyses précises et explicables. La MEASURE() fonction est appliquée automatiquement et les métadonnées de l’agent, telles que les synonymes, les noms d’affichage et la mise en forme, sont exposées dans l’interface utilisateur.
Agents Genie Utilisez des vues de métriques dans Genie Agents pour activer des analyses précises et expliquées basées sur l’IA.
Alertes Surveillez les mesures d’affichage des métriques et déclenchez des notifications lorsque des seuils sont franchis.
Analyse des requêtes Utilisez le profil de requête pour résoudre les problèmes et optimiser les requêtes d’affichage des métriques.
JDBC et ODBC Accéder aux vues de métriques via des connexions JDBC et ODBC. Les API de métadonnées exposent la structure d’affichage des métriques aux outils de décisionnel et d’analytique externes.
Outils décisionnels externes Interroger des vues de métriques dans Power BI, Tableau, Sigma et d’autres outils BI à l’aide de SQL personnalisé ou du mode de compatibilité BI.
module complémentaire Excel Interroger des vues de métriques depuis Microsoft Excel à l’aide du complément Excel Azure Databricks.
Google Sheets Interroger des vues de métriques à partir de Google Sheets à l’aide du connecteur Databricks.

Ressources supplémentaires

  • Last updated on