メインコンテンツまでスキップ

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

備考

プレビュー

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

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

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

  • リスティングへのアクセス: 完了した リクエストデータの 消費者情報を記録するか、リスティング のデータイベントを取得します
  • ファネルイベント: リスティングに対するインプレッションとアクションを記録します。
注記

Provider アナリティクス ダッシュボードを使用して、受信者の使用状況メトリクスを監視できます。 ダッシュボードは、 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_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メールアドレス。

consumer_name

string

消費者の名前。

consumer_company

string

消費者の会社。

consumer_intended_use

string

消費者によるリストの使用目的。

consumer_comments

string

消費者が残した追加のコメント。

event_type

string

アクセスの種類。 値は REQUEST_DATA または GET_DATAのいずれかです。

event_date

日付

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

event_time

タイムスタンプ

イベントが発生したときの正確な 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

タイムスタンプ

イベントが発生したときの正確な 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 テーブルでは、ABANDON_FAIL_DATAFAIL_GET_DATA のイベント タイプは 2023 年 11 月 30 日より前に記録されていません。

クエリの例

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

過去 10 日間の消費者リクエスト

SQL
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)

リクエスト数の多いリスティング

SQL
SELECT listing_name, consumer_cloud, count(*) as requestCount
FROM system.marketplace.listing_access_events
GROUP BY listing_name, consumer_cloud
ORDER BY requestCount DESC

上位のリクエスターを表示する

SQL
SELECT consumer_name, consumer_email, count(*) as requestCount
FROM system.marketplace.listing_access_events
GROUP BY consumer_name, consumer_email
ORDER BY requestCount DESC

リスティングで各消費者アクションが実行された回数を表示する

SQL
SELECT event_type, COUNT(*) as occurrences
FROM system.marketplace.listing_funnel_events
WHERE listing_name = :listing_name
GROUP BY event_type

ノートブック demo: Analyze the Marketplace システムテーブル

次のノートブックには、この記事のクエリの例と、さらに分析を行うための追加のセルが含まれています。

Marketplace システムテーブル デモ

Open notebook in new tab