メインコンテンツまでスキップ

メトリクス ビューのクエリ

サポートされているランタイムを実行するSQLウェアハウスまたはコンピュート リソースに接続されているSQLエディターから、標準ビューと同様にメトリクス ビューをクエリできます。 メトリクス ビューは、柔軟なグループ化とフィルタリングをサポートしているため、すべての集計を事前に計算することなく、ランタイムでディメンションの任意の組み合わせにわたってメジャーを分析できます。 このページに掲載されているクエリは、一般的なクエリパターンを示しています。

クエリのメジャーとディメンション

メトリクス ビュー クエリ内のすべてのメジャー評価では、 MEASURE集計関数を使用する必要があります。 詳細と構文については、 measure集計関数を参照してください。

注記

メトリクス ビューからすべてのディメンションとメジャーを選択するには、各ディメンションを明示的にリストし、各メジャーを集計関数MEASURE()で囲みます。 メジャーを正しく評価するにはMEASURE()関数が必要なので、 SELECT *を使用するのではなく、個々の列を指定する必要があります。

グループ化を含むクエリ

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

フィルタリングを使用したクエリ

SQL
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 の結果を結合します。

SQL
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;

Metrix ビューの定義とメタデータを表示する

次のクエリは、メジャー、ディメンション、結合、エージェント メタデータを含む、メトリクス ビューの完全な YAML 定義を返します。 AS JSON問題はオプションです。 構文の詳細については、 JSON形式の出力を参照してください。

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

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

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

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

ツール

説明

AI/BIダッシュボード

メトリクス ビューを使用して、正確で説明可能な分析を提供します。 MEASURE()関数は自動的に適用され、同義語、表示名、書式設定などのエージェントメタデータが UI に表示されます。

Genieスペース

Genie Spaces でメトリクス ビューを使用すると、正確で説明可能なAIを活用したアナリティクスが可能になります。

アラート

メトリクス ビューの測定値を監視し、しきい値を超えたときに通知をトリガーします。

クエリ分析

クエリ プロファイルを使用して、メトリクス ビュー クエリのトラブルシューティングと最適化を行います。

JDBCとODBC

JDBCおよびODBC接続を通じて Metrix ビューにアクセスします。 メタデータAPIsメトリクスのビュー構造を外部のBIおよびアナリティクス ツールに公開します。

外部BIツール

BI互換モードを使用して、外部BIツールからメトリクス ビューをクエリします。

Excelアドイン

Databricks Excelアドインを使用して、 Microsoft Excelからメトリクス ビューをクエリします。

Googleスプレッドシート

Databricksコネクタを使用して、Google スプレッドシートからメトリクス ビューをクエリします。

次のステップ