販売メトリクスをメトリクスビューとして定義する
「データをクエリーして探索する」ページでは、1つの保存済みクエリーを使用して日次のフランチャイズ収益をコンピュートします。メトリクスビューは、ロジックをガバナンスされたオブジェクトに変換します。「総売上」、「注文数」、「平均注文額」を1か所で定義すれば、ダッシュボード、Genieエージェント、SQLクライアントはすべて同じ定義を読み取ることができます。その定義のメジャーを変更すれば、変更後にランされるクエリーはその変更を使用します。
ソースはシルバーレイヤーです。出力はstarterjourney_catalog.bakehouse_gold.franchise_sales_metricsです。
要件
メトリックビューを作成するには、以下が必要です:
CREATE TABLEおよびメトリックビューを作成するスキーマのUSE SCHEMA、およびそのカタログのUSE CATALOGが必要です。ゴールドスキーマを作成するには、starterjourney_catalogに対するCREATE SCHEMAも必要です。SELECTbakehouse_silver.transactionsおよびbakehouse_silver.franchises上。CAN USEStarter 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ウェアハウスを添付し、以下をランします。
CREATE SCHEMA IF NOT EXISTS starterjourney_catalog.bakehouse_gold;
メトリクスビューの作成
bakehouse_goldスキーマに空のメトリクスビューを作成し、エディターで開きます。
- カタログエクスプローラーで、
bakehouse_goldスキーマを開き、 作成 > メトリクスビュー をクリックします。 - メトリクスビューの作成 ダイアログで、名前
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.
プレビューして保存
プレビュー をクリックしてフィールドとメジャーを確認し、 保存 をクリックします。
保存されたクエリーに対して検証します
SQLエディターでこのクエリーをランします。各メジャーを MEASURE() でラップし、 SELECT * を使用する代わりに各カラムをリストします。
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`)のようにバッククォートで囲みます。メトリクスビューのクエリーを参照してください。
次のステップ
-
- フランチャイズパフォーマンスダッシュボードの構築と共有
- このメトリクスビューで Bakehouse Franchise Performance ダッシュボードを作成する
-
- メトリクスビューYAML 構文リファレンス
- 結合、
rely、同義語、マテリアライゼーションなど、メトリクスビューのすべてのYAMLキーを検索します