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

プレビュー

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

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

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

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

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

注:

プロバイダー分析ダッシュボードを使用して、受信者の使用状況メトリックを監視できます。 ダッシュボードは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_typeOPENの場合は null 許容。

consumer_region

string

消費者の地域。 consumer_delta_sharing_recipient_typeOPENの場合は null 許容。

consumer_metastore_id

string

コンシューマーのメタストア ID。 consumer_delta_sharing_recipient_typeOPENの場合は 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 を表します。

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

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

event_date

日付

イベントが発生した UTC の日付。

consumer_cloud

string

消費者のクラウド。 consumer_delta_sharing_recipient_typeOPENの場合は null 許容。

consumer_region

string

消費者の地域。 consumer_delta_sharing_recipient_typeOPENの場合は 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_DATAFAIL_GET_DATAのイベントの種類が記録されていません。

クエリの例

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

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

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