カタログ エクスプローラー UI を使用してメトリクス ビューを作成する

メトリクス ビューを作成してビジネス ロジックを一元管理し、レポート サーフェス全体で一貫して主要業績評価指標を定義する方法を学習します。 このチュートリアルでは、Catalog Explorer UI を使用してメトリクス ビューを作成する方法を説明します。 SQL使用してメトリクス ビューを定義するには、 SQL使用したメトリクス ビューの作成と管理」およびCREATE VIEWを参照してください。

前提条件

• ソース データ オブジェクトに対するSELECT権限が必要です。
• メトリクス ビューを作成するスキーマでは、 CREATE TABLE権限とUSE SCHEMA権限が必要です。
• スキーマの親カタログに対するUSE CATALOG権限も必要です。
• Databricks Runtime 17.2 以降を実行しているSQLウェアハウスまたはその他のコンピュート リソースに対するアクセス許可を使用できます。

メタストア管理者またはカタログ所有者は、これらすべての権限を付与できます。スキーマ所有者またはMANAGE権限を持つユーザーは、スキーマに対するUSE SCHEMA権限とCREATE TABLE権限を付与できます。

ステップ 1: データソースを選択します

メトリクス ビューは、テーブル、ビュー、またはSQLクエリに基づくことができます。 このチュートリアルでは、 samplesカタログのtpchスキーマ内のordersテーブルを使用します。

1. クリックワークスペース サイドバーの カタログ 。
2. スキーマ ブラウザの検索バーを使用して、 samples.tpch.ordersテーブルを見つけます。 注文 をクリックするとテーブルの詳細が表示されます。
3. 作成 > メトリクス・ビュー をクリックします。
4. 名前を入力するか、名前をorders_metric_viewのままにしておきます。
5. 権限を持つカタログとスキーマを選択します。

ステップ 2: メトリクスを定義する

UI (Public Preview)

1. 行レベルのフィルターを追加するには、 [フィルター] をクリックします。列としてsource.o_orderdate選択し、演算子として 「より大きい」 を選択し、値として1990-01-01を入力して、 「閉じる」 をクリックします。

2. [ディメンション] タブをクリックします。

   • O 注文日 をクリックします: 表示名 としてOrder Monthを入力します。 式 フィールドで 「カスタム」 をクリックし、 DATE_TRUNC('MONTH', o_orderdate)と入力します。

   • O Orderstatus をクリックします: 表示名 としてOrder Statusを入力します。 [カスタム] をクリックし、次の式を入力します。

     SQL

     CASE
       WHEN o_orderstatus = 'O' THEN 'Open'
       WHEN o_orderstatus = 'P' THEN 'Processing'
       WHEN o_orderstatus = 'F' THEN 'Fulfilled'
     END

   • O をクリックします。Orderpriority: 注文優先順位 : 名前としてOrder Priorityを入力します。 「カスタム」 をクリックし、 SPLIT(o_orderpriority, '-')[1]を入力します。

   • 他のディメンションを削除するには、それらを選択し、 [削除] をクリックします。

3. [メジャー] タブをクリックします。

   • クリック 数 : 注文数 : 表示名としてOrder Countを入力します。 「カスタム」 をクリックし、 COUNT(1)を入力します。

   • 追加の対策ごとに 「+ 追加」 をクリックします。

     • 総収益 : 名前としてTotal Revenueと入力します。式の下で 「ビルダー」 をクリックし、フィールドsource.o_totalpriceを選択し、計算の下で 「SUM」 を選択します。

     

     • 顧客あたりの総収益 : 名前としてTotal Revenue per Customerを入力します。 「カスタム」 をクリックし、 SUM(o_totalprice) / COUNT(DISTINCT o_custkey)と入力します。

     • 未処理注文の合計収益 : 名前としてTotal Revenue for Open Ordersと入力します。 「カスタム」 をクリックし、 SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')と入力します。

     メジャーをプレビューするには、メジャー名の横にある プレビュー 。プレビューには、選択したウィンドウと時間ディメンションの測定結果が表示されます。たとえば、次のプレビューは、 注文月 の 現在の ウィンドウを使用した 合計収益 を示しています。

     

4. プレビュー タブをクリックします。

5. 保存 をクリックします。

メトリクス ビューは、メトリクス ビューに対する少なくともSELECT権限を持つユーザーが利用できるようになります。 権限の管理の詳細については、 「Unity Catalog の権限とセキュリティ保護可能なオブジェクト」を参照してください。ユーザーがこのメトリクス ビューをクエリする方法の詳細については、 「メトリクス ビューのクエリ」を参照してください。

メトリクス ビューを作成した後、 概要 ページでソース、フィルター、指定したメジャーとディメンションを確認できます。

YAML

このメトリクス ビューの YAML 定義には、次のトップレベル フィールドが含まれます。

• version : デフォルトは1.1です。これは、メトリクス ビュー仕様のバージョンです。
• source : samples.tpch.ordersは完全修飾テーブル名です。このメトリクス ビューのすべてのディメンションとメジャーは、指定されたテーブルをデータ ソースとして使用します。
• filter : このビューのすべてのクエリは、1990 年 1 月 1 日以降のo_orderdateを持つレコードを返します。
• dimensions : Order Month 、 Order Status 、およびOrder Priorityはディメンションとして定義されています。
• measures : 4 つのメジャー ( Order Count 、 Total Revenue 、 Total Revenue per Customer 、およびTotal Revenue for Open Orders ) が定義されており、それぞれに集計式が指定されています。

1. カタログとスキーマのドロップダウン メニューを使用して、メトリクス ビューを保存する場所を選択します。 クエリを実行するユーザーは、メトリクス ビューにアクセスするには、少なくともUSE CATALOGおよびUSE SCHEMA権限を持っている必要があります。

2. メトリクス ビューの名前を入力します。 メトリクス ビュー名には、英数字とアンダースコアを含めることができます。

3. エディターの内容を次の定義に置き換えます。

   YAML

   version: 1.1
   
   source: samples.tpch.orders
   
   filter: source.o_orderdate > '1990-01-01'
   
   dimensions:
     - name: Order Status
       expr: |-
         CASE
           WHEN o_orderstatus = 'O' THEN 'Open'
           WHEN o_orderstatus = 'P' THEN 'Processing'
           WHEN o_orderstatus = 'F' THEN 'Fulfilled'
         END
       display_name: Order Status
     - name: Order Month
       expr: "DATE_TRUNC('MONTH', o_orderdate)"
       display_name: Order Month
     - name: o_orderpriority
       expr: "SPLIT(o_orderpriority, '-')[1]"
       display_name: Order priority
   
   measures:
     - name: count
       expr: COUNT(1)
       display_name: Order Count
     - name: Total Revenue
       expr: SUM(source.o_totalprice)
       display_name: Total Revenue
     - name: Total Revenue per Customer
       expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
       display_name: Total Revenue Per Customer
     - name: Total Revenue for Open Orders
       expr: SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')
       display_name: Total Revenue For Open Orders

4. 作成 をクリックします。

メトリクス ビューは、メトリクス ビューに対する少なくともSELECT権限を持つユーザーが利用できるようになります。 権限の管理の詳細については、 「Unity Catalog の権限とセキュリティ保護可能なオブジェクト」を参照してください。ユーザーがこのメトリクス ビューをクエリする方法の詳細については、 「メトリクス ビューのクエリ」を参照してください。

メトリクス ビューを作成した後、開いた [概要] タブでソース、フィルター、指定したメジャーとディメンションを確認できます。

ステップ 3: 説明、コメント、タグを追加する

YAML 定義またはカタログ エクスプローラーの 概要 タブから説明、コメント、タグを追加できます。

Catalog Explorer

• カタログ エクスプローラーでメトリクス ビューをクリックします。
• [説明の追加] をクリックして、メトリクス ビューのメタデータに説明を追加します。
• コメントを追加するには、コメントを追加する行の コメント 列にカーソルを合わせます。
• メジャーまたはディメンションにタグを追加するには、タグを追加する タグ 列の上にマウスを置きます。
• メトリクス ビューにタグを追加するには、ページの右側にある [タグの追加] をクリックします。

YAML

YAML 定義にcommentフィールドを直接追加します。構文の詳細については、バージョン仕様の変更ログを参照してください。

YAML

version: 1.1
comment: 'Orders metrics for revenue analysis'

dimensions:
  - name: Order Month
    expr: DATE_TRUNC('MONTH', o_orderdate)
    comment: 'Month when the order was placed'

measures:
  - name: Total Revenue
    expr: SUM(o_totalprice)
    comment: 'Sum of all order prices'

ステップ 4: (オプション) YAML 定義を編集します

詳細 タブから YAML 定義を表示し、YAML エディターを開くことができます。

1. 詳細 をクリックします。
2. 完全な定義を表示するためには ...行を増やす をクリックします。
3. 編集 をクリックして YAML エディターを開きます。
4. ディメンションまたはメジャーを追加または削除します。 保存 をクリックします。

ステップ 5: (オプション) 権限を設定する

メトリクス ビューは、他の Unity Catalog セキュリティ保護可能なオブジェクトと同じ階層アクセス許可モデルを尊重します。 メトリクスビューが、目的のコンシューマーが読み取りアクセス権を持つスキーマに保存されている場合、新しいアクセス許可は必要ありません。メトリクスビューの権限は、 権限 タブから明示的に割り当てることができます。

1. [ アクセス許可 ]をクリックします。
2. UI を使用して、他の Databricks ユーザーの権限を付与したり取り消したりします。

詳細については、 「オブジェクトに対する権限の付与」を参照してください。

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

ワークスペースに組み込まれているSQLエディター、またはDatabricks上のデータにアクセスできる任意のSQLエディターからメトリクス ビューをクエリできます。 メトリクス ビューをクエリするには、 Databricks Runtime 17.2 以降を実行しているSQLまたはその他のコンピュート リソースに接続する必要があります。

次のサンプル クエリは、リストされている 3 つのメジャーを評価し、 Order MonthとOrder Statusを集計します。Order Monthでソートされた結果を返します。

すべてのメジャーはMEASURE関数でラップする必要があります。measure集計関数を参照してください。

SQL

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC

次のステップ

SQL使用してメトリクス ビューを作成したので、次の関連トピックを調べてください。

メトリクス ビューのクエリと使用

• メトリクス ビューをクエリします。
• AI/BIダッシュボードでメトリクス ビューを使用します。
• Genieでメトリクス ビューを使用します。
• メトリクス ビューにアラートを設定します。
• Power BIでメトリクス ビューをクエリします。

高度なメトリクス ビュー機能

• メトリクス ビューでセマンティック メタデータを使用します。
• メトリクス ビューで結合を使用します。
• メトリクス ビューでウィンドウ メジャーを使用します。
• YAML 構文リファレンス。

代替の作成方法

• SQL使用してメトリクス ビューを作成および管理します。
• CREATE VIEW 。
• ALTER VIEW 。
• DESCRIBE TABLE 。

ガバナンスとセキュリティ

• Unity Catalog で権限を管理します。
• グループ。
• Unity Catalog権限とセキュリティ保護可能なオブジェクト。