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

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

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

メジャーとフィールドのクエリ

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

注記

メトリクスビューからすべてのフィールドと計算式を選択するには、各フィールドを明示的にリストし、各計算式を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ツール

カスタム SQL または BI 互換モードを使用して、Power BI、Tableau、Sigma などの BI ツールからメトリクスビューを照会できます。

Excelアドイン

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

Googleスプレッドシート

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

次のステップ