メトリクスビューの作成と編集

このページでは、Catalog Explorer UI またはSQLを使用してメトリクスビューを作成および編集する方法を説明します。カタログエクスプローラーのユーザーインターフェースには、ローコードエディタとYAMLエディタが含まれています。SQLを書きたくない場合は、ローコードUIが良い出発点となります。

より複雑な例については、「チュートリアル: 結合を使用して完全なメトリクスビューを構築する」を参照してください。

前提条件

メトリクスビューを作成または編集する前に、次の権限があることを確認してください。

SELECT ソースとして使用されるテーブルライクなアセットまたはSQLクエリに対する権限。
メトリクスビューを作成するスキーマ内のCREATE TABLEおよびUSE SCHEMA権限。
USE CATALOG親カタログに対する権限。
CAN USE Databricks Runtime 17.3 以降を実行するSQLウェアハウスまたはその他のコンピュートリソースに対するアクセス許可。

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

メトリクスビューの作成

メトリクスビューは、カタログエクスプローラー UI、 SQL 、または YAML エディターを使用して作成できます。

Catalog Explorer UI
SQL
YAML editor

カタログエクスプローラーのローコードUIでは、YAMLを直接記述することなく、フィールドとメジャーをインタラクティブに定義できます。

クリックワークスペースのサイドバーにある カタログ 。
検索バーを使って、目的のソーステーブルを探してください。例えば、 samples.tpch.ordersを検索します。
テーブル名をクリックすると、テーブルの詳細が表示されます。
[作成] > [メトリクスビュー] をクリックします。 [メトリクスビューの作成] ダイアログで、名前を入力し、カタログとスキーマの宛先を選択します。次に 「作成」 をクリックします。
必要に応じて、 UI をクリックしてローコードエディタを開きます。

フィールドを定義します

フィールドは、通常のテーブルの列のように動作するメトリクスビューの列です。これらは、グループ化とフィルタリングに使用されるカテゴリ属性（注文月や注文ステータスなど）、またはクエリ時に集計できる未集計の数値列（価格や数量など）として扱うことができます。すべてのソース列はフィールドとして自動的に追加されます。

フィールド の下の追加をクリックします。
フィールド式を定義するには、式フィールドにSQL式を入力します。例えば、「DATE_TRUNC('month', o_orderdate)」と入力して、注文を月別にグループ化します。
必要に応じて、 AIで生成 をクリックして、Genie Codeを使用してフィールド式を提案します。
必要に応じて、 表示名 、 コメント 、 同義語 、書式、またはタグを入力してください。 この書式は 、数値、日付、および日時型の列でのみ利用可能です。

対策を定義する

メジャーは、総収益や注文数などのビジネスメトリクスを生成する集計式です。

クリック 「対策」 の下に 追加してください 。
式フィールドにSQL集計式を入力します。サポートされている集計には、合計、カウント、平均、最小、最大、中央値、パーセンタイルが含まれます。たとえば、「SUM(o_totalprice)」と入力して、合計収益を計算します。
必要に応じてクリック AIで生成して 、Genie Codeを使用して測定式を提案します。
必要に応じて、 表示名 、 コメント 、 同義語 、書式、またはタグを入力してください。

メジャーをプレビューするには、メジャー名の横にある「プレビュー」をクリックします。プレビューは、選択した時間枠とフィールドのメジャー結果を表示します。
保存をクリックします。

メトリクスビューを作成するには、 CREATE VIEW WITH METRICS句とともに使用します。 YAML定義を$$区切り文字で指定してください。

SQL
CREATE OR REPLACE VIEW orders_metric_view WITH METRICS LANGUAGE YAML AS
$$
  version: 1.1
  comment: "Orders KPIs for sales analysis"
  source: samples.tpch.orders
  filter: o_orderdate > '1990-01-01'

  fields:
    - name: Order Month
      expr: DATE_TRUNC('MONTH', o_orderdate)
      comment: "Month of order"

    - name: Order Status
      expr: CASE
        WHEN o_orderstatus = 'O' THEN 'Open'
        WHEN o_orderstatus = 'P' THEN 'Processing'
        WHEN o_orderstatus = 'F' THEN 'Fulfilled'
        END
      comment: "Status of order"

    - name: o_orderdate
      expr: o_orderdate
      comment: "Original order date"

    - name: o_orderkey
      expr: o_orderkey
      comment: "Order key"

    - name: o_custkey
      expr: o_custkey
      comment: "Customer key"

    - name: o_orderpriority
      expr: o_orderpriority
      comment: "Order priority"

    - name: o_clerk
      expr: o_clerk
      comment: "Clerk"

    - name: o_shippriority
      expr: o_shippriority
      comment: "Ship priority"

    - name: o_comment
      expr: o_comment
      comment: "Order comment"

  measures:
    - name: Order Count
      expr: COUNT(1)
      comment: "Total number of orders"

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

    - name: Total Revenue per Customer
      expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
      comment: "Average revenue per unique customer"
$$

YAML 構文の詳細については、「メトリクスビュー YAML 構文リファレンス」を参照してください。

クリックワークスペースのサイドバーにある カタログ 。
検索バーを使って、目的のソーステーブルを探してください。例えば、 samples.tpch.ordersを検索します。
テーブル名をクリックすると、テーブルの詳細が表示されます。
[作成] > [メトリクスビュー] をクリックします。 [メトリクスビューの作成] ダイアログで、名前を入力し、カタログとスキーマの宛先を選択します。次に 「作成」 をクリックします。
YAML をクリックすると、YAMLエディタが開きます。

YAML定義を入力して 「作成」 をクリックしてください。SQLの例では、以下の定義が使用されています。

YAML
version: 1.1
comment: 'Orders KPIs for sales analysis'
source: samples.tpch.orders
filter: o_orderdate > '1990-01-01'

fields:
  - name: Order Month
    expr: DATE_TRUNC('MONTH', o_orderdate)
    comment: 'Month of order'

  - name: Order Status
    expr: CASE
      WHEN o_orderstatus = 'O' THEN 'Open'
      WHEN o_orderstatus = 'P' THEN 'Processing'
      WHEN o_orderstatus = 'F' THEN 'Fulfilled'
      END
    comment: 'Status of order'

  - name: o_orderdate
    expr: o_orderdate
    comment: 'Original order date'

  - name: o_orderkey
    expr: o_orderkey
    comment: 'Order key'

  - name: o_custkey
    expr: o_custkey
    comment: 'Customer key'

  - name: o_orderpriority
    expr: o_orderpriority
    comment: 'Order priority'

  - name: o_clerk
    expr: o_clerk
    comment: 'Clerk'

  - name: o_shippriority
    expr: o_shippriority
    comment: 'Ship priority'

  - name: o_comment
    expr: o_comment
    comment: 'Order comment'

measures:
  - name: Order Count
    expr: COUNT(1)
    comment: 'Total number of orders'

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

  - name: Total Revenue per Customer
    expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
    comment: 'Average revenue per unique customer'

YAML 構文の詳細については、「メトリクスビュー YAML 構文リファレンス」を参照してください。

警告

メトリクスビューのフィールドは、ソース列がCHARまたはVARCHARの場合でも、常にSTRINGです。テーブル境界に適用されたCHAR(n)のスペースパディングは失われるため、ソーステーブルとの比較結果が異なる可能性があります。例えば、CHAR(10) の値 'COLLEGE' は 'COLLEGE ' として保存されます。そのため、column = 'COLLEGE' はテーブルでは true を返しますが、メトリクスビューフィールドでは false を返します。

少なくともSELECT権限を持つユーザーは、メトリクスビューにクエリを実行できるようになります。権限の管理方法について詳しくは、「権限の設定」を参照してください。

Genie Codeを使用してメトリクスビューを生成する

Genie Code 、平易な言語の記述からメトリクスビュー定義を生成できます。

Genie Codeアイコンをクリックしてくださいワークスペースの右上隅にある
作成するメトリクスビューについて説明します。 Genie CodeはSQL DDLを返します。
SQL文をコピーして、 SQLエディタに貼り付けてください。Click 実行 .
SQLを編集するか、メトリクスビューエディタを開いて調整を行います。「メトリクスビューの編集」を参照してください。

メトリクスビューを編集する

メトリクスビューの定義を編集するには、そのビューの所有者である必要があります。共同編集を有効にするには、所有権をグループに譲渡してください。共同編集を有効にする方法については、こちらをご覧ください。

Catalog Explorer UI
SQL
YAML editor

カタログエクスプローラーでメトリクスビューを見つけます。
「編集」 をクリックしてエディターを開きます。
UI をクリックすると、ローコードUIが表示されます。
編集するメジャーまたはフィールドをクリックします。変更を加えて、**保存**をクリックしてください。
新しいフィールドまたはメジャーを追加するには、編集したいセクションで[ **追加**] をクリックします。新しいメジャーとフィールドの定義に関する詳細な手順については、「メトリクスビューを作成する」を参照してください。

更新されたYAML定義でALTER VIEWを使用してください。

SQL
ALTER VIEW catalog.schema.orders_metric_view
AS $$
version: 1.1
comment: "Orders KPIs for sales analysis"
source: samples.tpch.orders
filter: o_orderdate > '1990-01-01'

fields:
 - name: Order Month
   expr: DATE_TRUNC('MONTH', o_orderdate)
   comment: "Month of order"

 - name: Order Status
   expr: CASE
     WHEN o_orderstatus = 'O' THEN 'Open'
     WHEN o_orderstatus = 'P' THEN 'Processing'
     WHEN o_orderstatus = 'F' THEN 'Fulfilled'
     END
   comment: "Status of order"

measures:
 - name: Order Count
   expr: COUNT(1)
   comment: "Total number of orders"

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

 - name: Total Revenue per Customer
   expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)
   comment: "Average revenue per unique customer"

 - name: Total Revenue for Open Orders
   expr: SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')
   comment: "Revenue from open orders"
$$

その他のリソース

メトリクスビューを作成した後、次のリソースを使用して、作業のクエリ、管理、および拡張を行います。

クエリと消費

管理および統治

高度な機能

例

チュートリアル: 結合を使用して完全なメトリクスビューを構築する

前提条件​

メトリクス ビューの作成​

Genie Codeを使用してメトリクス ビューを生成する​

メトリクス ビューを編集する​

その他のリソース​

クエリと消費​

管理および統治​

高度な機能​

例​