クエリ メトリック ビュー

SQL ウェアハウスにアタッチされている任意の SQL エディターや、サポートされているランタイムを実行しているコンピューティング リソースから、標準ビューなどのメトリック ビューに対してクエリを実行できます。 メトリック ビューを使用すると、柔軟なグループ化とフィルター処理が可能になります。 すべての集計を事前計算することなく、実行時にフィールド（ディメンションとも呼ばれる）の任意の組み合わせで指標を分析できます。 このページのクエリは、一般的なクエリ パターンを示しています。

クエリの指標とフィールド

メトリック ビュー クエリのすべてのメジャー評価では、 MEASURE 集計関数を使用する必要があります。 完全な詳細と構文については、集計関数measure参照してください。 Databricks Runtime 18.1 以降では、 agg を使用することもできます。

グループ化を使用したクエリ

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

フィルター処理を使用したクエリ

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

他のテーブルを使用したクエリ

メトリック ビューは、クエリ時に他のテーブルと直接結合することはできません。 メトリック ビューを別のテーブルと結合するには、メトリック ビュー クエリを CTE でラップしてから、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;

パラメーターを使用してメトリック ビューにクエリを実行する

パラメーターを定義するメトリック ビューにクエリを実行するには、それをテーブル値関数として呼び出し、各パラメーターを名前付き引数として渡します。 詳細と例については、「 パラメーターを使用したメトリック ビューのクエリ」を参照してください。

メトリック ビューの定義とメタデータを表示する

次のクエリは、メジャー、フィールド、結合、 エージェント メタデータなど、メトリック ビューの完全な YAML 定義を返します。 AS JSON パラメーターは省略可能です。 完全な構文の詳細については、 JSON 形式の出力を参照してください。

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

結果の [ テキストの表示 ] フィールドに、完全な YAML 定義が表示されます。 各列には、エージェント メタデータ を保持するメタデータフィールドが含まれています。

ツールでメトリック ビューを使用する

Azure Databricks ワークスペース全体および外部ツールでメトリック ビューを使用することもできます。

その他のリソース

• メトリック ビューを管理する
• モデル メトリック ビュー
• メトリック ビューを使用する
• Genie エージェントを作成する