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

プレビュー

このシステムテーブルは パブリック プレビュー段階です。 テーブルにアクセスするには、 system カタログでスキーマを有効にする必要があります。 詳細については、「 システムテーブル スキーマを有効にする」を参照してください。

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

Marketplaceシステムテーブルは system.marketplace スキーマに存在します。 次のテーブルを使用できます。

• リスティングへのアクセス: リスティングで完了した リクエストデータ または データ取得 イベントのコンシューマー情報を記録します。

• ファネル イベント: リスティングで実行されたインプレッションとアクションを記録します。

注：

プロバイダー分析ダッシュボードを使用して、受信者の使用状況メトリックを監視できます。 ダッシュボードはMarketplaceシステムテーブルからデータを取得します。 「ダッシュボードを使用してリストの使用状況メトリックを監視する」を参照してください。

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

リスティングアクセスイベントテーブルは、完了した リクエストデータ またはリスティングのデータ イベントの取得 に関する消費者情報を取得します。

テーブルパス:このシステムテーブルは 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 タイムスタンプ。 タイムゾーン情報は値の末尾に記録され、 +00:00は UTC を表します。

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

リスティングファネルのイベント表では、リスティングに対するインプレッションとアクションが分析されます。 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 タイムスタンプ。 タイムゾーン情報は値の末尾に記録され、 +00:00は 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 Cloudの消費者アクティビティは含まれていません。

• 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プレイスシステムテーブルデモ

ノートブックを新しいタブで開く インポート用のリンクをコピー