Eseguire query sulle visualizzazioni delle metriche

È possibile eseguire query su viste metriche come viste standard da qualsiasi editor SQL collegato a un SQL Warehouse o a una risorsa di calcolo che esegue un runtime supportato. Le visualizzazioni delle metriche consentono il raggruppamento e il filtro flessibili. È possibile analizzare le misure in qualsiasi combinazione di campi (denominati anche dimensioni) in fase di esecuzione senza eseguire il pre-calcolo di ogni aggregazione. Le query in questa pagina illustrano modelli di query comuni.

Eseguire query su misure e campi

Tutte le valutazioni delle misure in una query di visualizzazione delle metriche devono usare la MEASURE funzione di aggregazione. Per informazioni dettagliate e sintassi complete, vedere measure Funzione di aggregazione. In Databricks Runtime 18.1 e versioni successive è anche possibile usare agg.

Query con raggruppamento

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

Query con filtro

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

Eseguire query con altre tabelle

Le viste delle metriche non possono essere unite direttamente con altre tabelle durante la fase di interrogazione. Per unire una vista metrica a un'altra tabella, inserire la query della vista metrica in un CTE, quindi unire il risultato del 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;

Eseguire una query su una vista delle metriche con parametri

Per eseguire una query su una vista metrica che definisce i parametri, chiamarla come funzione con valori di tabella e passare ogni parametro come argomento denominato. Per dettagli ed esempi, consulta Eseguire una query su una vista metrica con parametri.

Visualizzare la definizione e i metadati della visualizzazione delle metriche

La query seguente restituisce la definizione YAML completa per una visualizzazione metrica, inclusi misure, campi, join e metadati dell'agente. Il parametro AS JSON è facoltativo. Per informazioni dettagliate sulla sintassi completa, vedere Output in formato JSON.

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

La definizione YAML completa viene visualizzata nel campo Visualizza testo nei risultati. Ogni colonna contiene un campo di metadati che contiene i metadati dell'agente.

Usare le visualizzazioni delle metriche negli strumenti

È anche possibile usare le visualizzazioni delle metriche nell'area di lavoro Azure Databricks e negli strumenti esterni:

Risorse aggiuntive

• Gestire le visualizzazioni delle metriche
• Visualizzazioni delle metriche del modello
• Usare le visualizzazioni delle metriche
• Creare un agente Genie