Marketplaceプレイスシステムテーブルリファレンス

プレビュー

この記事では、システムテーブルを使用してDatabricks Marketplace販売プロセスを運用化する方法の概要を説明します。

Marketplaceシステムテーブルはすべて system.marketplace スキーマ内に存在します。現在、次のテーブルが稼働しています。

リスティングへのアクセス: リスティングで完了した リクエストデータ または データ取得 イベントのコンシューマー情報を記録します。
ファネルイベント: リスティングで実行されたインプレッションとアクションを記録します。

アクセス・イベント・テーブルのリスト

listing_access_eventsテーブルは、リスティングの完了したリクエストデータまたはデータ取得イベントのコンシューマー情報を取得します。

system.marketplace.listing_access_events には、次のスキーマがあります。

列名	データ型	説明
`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	消費者が 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	消費者のEメールアドレス。 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 タイムスタンプ。

ファネルイベントテーブルの一覧表示

listing_funnel_events表では、リスティングの表示回数とアクションが分析されます。event_typeは、消費者がリストに対してどのようなアクションを実行したかを示します。

system.marketplace.listing_funnel_events には、次のスキーマがあります。

列名	データ型	説明
`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 タイムスタンプ。
`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システムテーブルには、 Databricks on Google Cloudを使用している消費者のアクティビティが含まれています。表には、この日付より前の Google クラウドの消費者アクティビティは含まれていません。
listing_funnel_events の表では、2023 年 11 月 30 日より前にABANDON_FAIL_DATAとFAIL_GET_DATAのイベントの種類が記録されていません。

クエリの例

このセクションには、リスティング上の消費者のアクティビティに関する洞察を得るために使用できる次のサンプルクエリが含まれています。

過去 10 日間の消費者の要求
要求数別の上位リスト
上位の要求者を表示する
リスティングに対して各消費者アクションが実行された回数を表示する

過去 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システムテーブルを分析する

次のノートブックには、この記事のサンプルクエリと、さらに詳細な分析を提供する追加のセルが含まれています。

Marketplaceプレイスシステムテーブルデモ

ノートブックを新しいタブで開く