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

販売メトリクスをメトリクスビューとして定義する

「データをクエリーして探索する」ページでは、1つの保存済みクエリーを使用して日次のフランチャイズ収益をコンピュートします。メトリクスビューは、ロジックをガバナンスされたオブジェクトに変換します。「総売上」、「注文数」、「平均注文額」を1か所で定義すれば、ダッシュボード、Genieエージェント、SQLクライアントはすべて同じ定義を読み取ることができます。その定義のメジャーを変更すれば、変更後にランされるクエリーはその変更を使用します。

ソースはシルバーレイヤーです。出力はstarterjourney_catalog.bakehouse_gold.franchise_sales_metricsです。

要件​

メトリックビューを作成するには、以下が必要です:

  • CREATE TABLE およびメトリックビューを作成するスキーマの USE SCHEMA、およびそのカタログの USE CATALOG が必要です。ゴールドスキーマを作成するには、starterjourney_catalog に対する CREATE SCHEMA も必要です。
  • SELECT bakehouse_silver.transactionsおよびbakehouse_silver.franchises上。
  • CAN USE Starter Warehouse などの SQL Warehouse で、または 18.1 以降の Databricks Runtime を ラン するコンピュートで実行します。
注記

Databricks Runtime 16.4 以降でメトリクス ビューを作成できます。このページの例では 18.1 以降が必要です。これは YAML で結合時に rely.at_most_one_match が設定されるためです。フィールドとメジャーのシノニムとコメントも YAML 仕様 1.1 が必要です。SQLウェアハウスは両方の要件を満たしています。

メトリクスビューの構築​

ゴールドスキーマを作成し、Genie Codeまたはfallback YAMLを使用してメトリクスビューを定義し、保存されたクエリーに対して合計を確認します。

ゴールドスキーマを作成する​

SQLエディターで、 Starter Warehouse などのSQLウェアハウスを添付し、以下をランします。

SQL
CREATE SCHEMA IF NOT EXISTS starterjourney_catalog.bakehouse_gold;

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

bakehouse_goldスキーマに空のメトリクスビューを作成し、エディターで開きます。

  1. カタログエクスプローラーで、bakehouse_gold スキーマを開き、 作成 > メトリクスビュー をクリックします。
  2. メトリクスビューの作成 ダイアログで、名前franchise_sales_metricsを入力し、カタログstarterjourney_catalogとスキーマbakehouse_goldを選択してから、 作成 をクリックします。

Genie Codeで定義を生成​

エディタで、右上隅のアイコンからGenie Codeを開き、次のプロンプトを貼り付けます:

プロンプト

Tell Genie Code to do this for you:

Create a metric view on starterjourney_catalog.bakehouse_silver.transactions joined to starterjourney_catalog.bakehouse_silver.franchises on franchise_id, many-to-one. Add fields: franchise (the franchise_name from the join), sales_date (the transaction_timestamp truncated to a day), and product. Add measures: total_sales as SUM(total_price), order_count as COUNT(1), and avg_order_value as total_sales divided by order_count. Add the synonyms "revenue" and "sales" to total_sales, and "AOV" to avg_order_value.

定義を確認する​

生成された定義をこのリストと照らし合わせる:

  • ソースは bakehouse_silver.transactions で、franchise_id で bakehouse_silver.franchises に結合されます (多対一)。
  • フィールドはfranchise、sales_date(日単位)、およびproductです。
  • 尺度は、SUM(total_price)としてtotal_sales、COUNT(1)としてorder_count、MEASURE(total_sales) / MEASURE(order_count)としてavg_order_valueです。

フィールドとメジャーの名前は重要です。ダッシュボードとGenie Agentのページはそれらを参照しているため、生成された名前が上記のリストと異なる場合はリネームしてください。

Use the fallback YAML

Open the YAML editor with the <> button, replace the definition with the following, and then continue.

YAML
version: 1.1
comment: 'Franchise sales KPIs for the Bakehouse journey'
source: starterjourney_catalog.bakehouse_silver.transactions
joins:
- name: franchise_dim
source: starterjourney_catalog.bakehouse_silver.franchises
'on': source.franchise_id = franchise_dim.franchise_id
rely:
at_most_one_match: true
fields:
- name: franchise
expr: franchise_dim.franchise_name
comment: 'Franchise name'
- name: sales_date
expr: DATE(source.transaction_timestamp)
comment: 'Calendar day of the transaction'
- name: product
expr: source.product
comment: 'Product sold'
measures:
- name: total_sales
expr: SUM(source.total_price)
comment: 'Sum of transaction total price'
synonyms: ['revenue', 'sales']
- name: order_count
expr: COUNT(1)
comment: 'Number of transactions'
- name: avg_order_value
expr: MEASURE(total_sales) / MEASURE(order_count)
comment: 'Average order value'
synonyms: ['AOV']

プレビューして保存​

プレビュー をクリックしてフィールドとメジャーを確認し、 保存 をクリックします。

保存されたクエリーに対して検証します​

SQLエディターでこのクエリーをランします。各メジャーを MEASURE() でラップし、 SELECT * を使用する代わりに各カラムをリストします。

SQL
SELECT
`sales_date`,
`franchise`,
MEASURE(`total_sales`) AS total_sales
FROM starterjourney_catalog.bakehouse_gold.franchise_sales_metrics
GROUP BY ALL
ORDER BY `sales_date`, `franchise`;

フランチャイズごとの日次合計は、保存したフランチャイズの日次収益クエリーと一致する必要があります。クエリーの保存を参照してください。一致しない場合は、結合とメジャーを確認してください。

証明とハンドオフ​

数値が一致したら、system.certification_status システム管理タグに certified 値を適用してメトリクスビューに適用します。そのタグに対する ASSIGN 権限が必要です。データを認定済みまたは非推奨としてフラグを設定するを参照してください。

メトリクスビューの定義を編集できるのは所有者だけです。チームがそれを管理できるように、ソーステーブルに対するSELECTをグループに付与し、メトリクスビューの所有権をそのグループに転送します。各グループメンバーは、定義を編集できます。Databricks は、マテリアライズされたメトリクスビューの所有権の転送をサポートしていません。共同編集を有効にするを参照してください。

トラブルシューティング​

これらのエントリを使用して、作成ダイアログ、合計、フィールド名、および MEASURE() 関数のトラブルシューティングを行います。

メトリクスビューの作成が失敗するか、オプションが利用できません

SQL Warehouse、またはDatabricks Runtime 18.1以降をランするコンピュートをアタッチし、そこにCAN USEがあることを確認します。

合計が膨らんでいるようです

default のジョインカーディナリティは many_to_one であり、ジョインされたテーブルをディメンションルックアップとして取り扱います。franchise_id あたりの行数が複数あるフランチャイズジョインで rely.at_most_one_match: true を設定すると、合計が不当に増幅されます。Databricks はランタイムで rely 設定を検証しないため、重複する一致によって SUM および COUNT が誤った結果を返す可能性があります。フランチャイズジョインが franchise_id で多対1であり、franchises のフランチャイズごとに 1 行あることを確認してください。

Genie Codeが異なるフィールド名を使用しました

ダッシュボードおよびGenie Agentページは、franchise、sales_date、product、total_sales、order_count、およびavg_order_valueを使用します。生成されたフィールドとメジャーの名前を一致するように変更するか、fallback YAMLを貼り付けます。

日計が保存されたクエリーと一致しません

sales_date が transaction_timestamp を日に切り捨てること、および total_sales が total_price を合計することを確認します。2 つのクエリー間のタイムゾーンの違いを調整します。

MEASURE関数に関するエラーでクエリーが失敗する

すべてのメジャーを MEASURE() でラップし、メジャーの表示名ではなく name を渡します。名前にスペースが含まれている場合は、MEASURE(`Total Revenue`)のようにバッククォートで囲みます。メトリクスビューのクエリーを参照してください。

次のステップ​