Marketplace システム テーブル リファレンス
重要
この機能はパブリック プレビュー段階にあります。
この記事では、システム テーブルを使用して、Databricks Marketplace 販売プロセスを運用可能にする方法の概要について説明します。
Marketplace システム テーブルは system.marketplace
スキーマに従います。 以下のテーブルが利用できます。
- リスティング アクセス: リスティングに対する完了した "データ要求" または "データ取得" イベントに関するコンシューマーの情報を記録します。
- ファネル イベント: リスティングに対して行われたインプレッションとアクションを記録します。
Note
プロバイダー分析ダッシュボードを使用すると、受信者の使用状況メトリックを監視できます。 ダッシュボードは、Marketplace システム テーブルからデータをプルします。 「ダッシュボードを使用したリスティング使用状況メトリックの監視」を参照してください。
リスティング アクセス イベント テーブル
listing_access_events
テーブルは、リスティング上の完了した "データ要求" または "データ取得" イベントのコンシューマー情報を取得します。
system.marketplace.listing_access_events
のスキーマは次のとおりです。
列名 | データ型 | Description |
---|---|---|
account_id |
string | リスティングをホストするアカウント ID。 |
metastore_id |
string | リスティングをホストするメタストア ID。 |
metastore_cloud |
string | リスティングをホストするメタストアのクラウド プロバイダー。 |
metastore_region |
string | リスティングをホストするメタストアのリージョン。 |
provider_id |
string | プロバイダー プロファイル ID。 |
provider_name |
string | プロバイダー プロファイル名。 |
listing_id |
string | リスティング ID。 |
listing_name |
string | リスティング名。 |
consumer_delta_sharing_recipient_name |
string | コンシューマーの基になる Delta Sharing の受信者名。 event_type が REQUEST_DATA である場合、値は null です。 |
consumer_delta_sharing_recipient_type |
string | コンシューマーが Azure Databricks アカウント上にあるかどうか。 値は OPEN または DATABRICKS のどちらかになります。 |
consumer_cloud |
string | コンシューマーのクラウド。 consumer_delta_sharing_recipient_type が OPEN である場合、Null 許容です。 |
consumer_region |
string | コンシューマーのリージョン。 consumer_delta_sharing_recipient_type が OPEN である場合、Null 許容です。 |
consumer_metastore_id |
string | コンシューマーのメタストア ID。 consumer_delta_sharing_recipient_type が OPEN である場合、Null 許容です。 |
consumer_email |
string | コンシューマーのメール アドレス。 PII。 |
consumer_name |
string | コンシューマーの名前。 PII。 |
consumer_company |
string | コンシューマーの会社。 |
consumer_intended_use |
string | コンシューマーが意図するリスティングの使用。 |
consumer_comments |
string | コンシューマーが残した何らかの追加コメント。 |
event_type |
string | アクセスの種類です。 値は REQUEST_DATA と GET_DATA のいずれかにできます。 |
event_date |
日にち | イベントが発生した UTC の日付。 |
event_time |
timestamp | イベントが発生したときの正確なタイムスタンプ。 タイムゾーン情報は、UTC を表す +00:00 という形式で値の末尾に記録されます。 |
リスティング ファネル イベント テーブル
listing_funnel_events
テーブルは、リスティングに対して行われたインプレッションとアクションを分析します。 event_type
を見ると、コンシューマーがリスティングに対して行ったアクションがわかります。
system.marketplace.listing_funnel_events
のスキーマは次のとおりです。
列名 | データ型 | Description |
---|---|---|
account_id |
string | リスティングをホストするアカウント ID。 |
metastore_id |
string | リスティングをホストするメタストア ID。 |
metastore_cloud |
string | リスティングをホストするメタストアのクラウド プロバイダー。 |
metastore_region |
string | リスティングをホストするメタストアのリージョン。 |
provider_id |
string | プロバイダー プロファイル ID。 |
provider_name |
string | プロバイダー プロファイル名。 |
listing_id |
string | リスティング ID。 |
listing_name |
string | リスティング名。 |
event_type |
string | コンシューマー アクションの種類。 「イベントの種類」をご覧ください。 |
event_time |
timestamp | イベントが発生したときの正確なタイムスタンプ。 タイムゾーン情報は、UTC を表す +00:00 という形式で値の末尾に記録されます。 |
event_date |
日付 | イベントが発生した UTC の日付。 |
consumer_cloud |
string | コンシューマーのクラウド。 consumer_delta_sharing_recipient_type が OPEN である場合、Null 許容です。 |
consumer_region |
string | コンシューマーのリージョン。 consumer_delta_sharing_recipient_type が OPEN である場合、Null 許容です。 |
イベントの種類
event_type 列には、次の値が設定される可能性があります。
VIEW_LISTING
START_REQUEST_DATA
COMPLETE_REQUEST_DATA
ABANDON_REQUEST_DATA
START_GET_DATA
COMPLETE_GET_DATA
ABANDON_GET_DATA
UNINSTALL_DATA
FAIL_REQUEST_DATA
FAIL_GET_DATA
既知の制限事項
- 2024 年 3 月 12 日の時点で、Marketplace のシステム テーブルには、Google Cloud で Databricks を使用するコンシューマーからのアクティビティが含まれています。 テーブルには、この日付より前の Google Cloud コンシューマー アクティビティは含まれません。
listing_funnel_events
テーブルのイベントの種類ABANDON_FAIL_DATA
とFAIL_GET_DATA
は、2023 年 11 月 30 日より前には記録されませんでした。
クエリの例
このセクションには、リスティング上のコンシューマー アクティビティに関する分析情報を取得するために使用できる次のサンプル クエリが含まれています。
過去 10 日間のコンシューマー要求
SELECT event_date, provider_name, listing_name, listing_id, consumer_delta_sharing_recipient_name, consumer_cloud, consumer_region, consumer_name, consumer_email, consumer_company
FROM system.marketplace.listing_access_events
WHERE event_type = 'REQUEST_DATA'
AND event_date >= date_add(current_date(), -10)
要求数別の上位のリスティング
SELECT listing_name, consumer_cloud, count(*) as requestCount
FROM system.marketplace.listing_access_events
GROUP BY listing_name, consumer_cloud
ORDER BY requestCount DESC
上位の要求者を表示する
SELECT consumer_name, consumer_email, count(*) as requestCount
FROM system.marketplace.listing_access_events
GROUP BY consumer_name, consumer_email
ORDER BY requestCount DESC
各コンシューマー アクションがリスティングに対して実行された回数を表示する
SELECT event_type, COUNT(*) as occurrences
FROM system.marketplace.listing_funnel_events
WHERE listing_name = `{{listing_name}}`
GROUP BY event_type
ノートブックのデモ: Marketplace システム テーブルを分析する
次のノートブックには、この記事のクエリの例と共に、それ以外の分析を提供する追加のセルが含まれています。