次の方法で共有

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

重要

このシステム テーブルは パブリック プレビュー にあります。

このページでは、システム テーブルを使用して Databricks Marketplace の販売プロセスを監視する方法に関するリファレンスを提供します。

Marketplace システム テーブルは system.marketplace スキーマに従います。 このスキーマは、メタストアで Marketplace 登録情報が作成されると自動的に有効になります。 スキーマには、次の表が含まれています。

  • リスティング アクセス: リスティングに対する完了した "データ要求" または "データ取得" イベントに関するコンシューマーの情報を記録します。
  • ファネル イベント: リスティングに対して行われたインプレッションとアクションを記録します。

注

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

リスティング アクセス イベント テーブル

リスト アクセス イベント テーブルは、完了した要求データのコンシューマー情報を取得するか一覧のデータイベント取得します。

テーブル パス: このシステム テーブルは、 system.marketplace.listing_access_eventsにあります。

列名 データ型 説明
account_id 文字列 リスティングをホストするアカウント ID。
metastore_id 文字列 一覧をホストするメタストア ID。
metastore_cloud 文字列 リスティングをホストするメタストアのクラウド プロバイダー。
metastore_region 文字列 リスティングをホストするメタストアのリージョン。
provider_id 文字列 プロバイダー プロファイル ID。
provider_name 文字列 プロバイダー プロファイル名。
listing_id 文字列 リスティング ID。
listing_name 文字列 リスティング名。
consumer_delta_sharing_recipient_name 文字列 コンシューマーの基になる Delta Sharing の受信者名。 event_type が null である場合、値は REQUEST_DATA です。
consumer_delta_sharing_recipient_type 文字列 コンシューマーが Azure Databricks アカウント上にあるかどうか。 値は OPEN または DATABRICKS のどちらかになります。
consumer_cloud 文字列 コンシューマーのクラウド。 consumer_delta_sharing_recipient_type が OPEN である場合、Null 許容です。
consumer_region 文字列 コンシューマーのリージョン。 consumer_delta_sharing_recipient_type が OPEN である場合、Null 許容です。
consumer_metastore_id 文字列 コンシューマーのメタストア ID。 consumer_delta_sharing_recipient_type が OPEN である場合、Null 許容です。
consumer_email 文字列 コンシューマーのメール アドレス。
consumer_name 文字列 コンシューマーの名前。
consumer_company 文字列 消費者の会社。
consumer_intended_use 文字列 コンシューマーによるリストの使用目的。
consumer_comments 文字列 コンシューマーが残した何らかの追加コメント。
event_type 文字列 アクセスの種類です。 値は REQUEST_DATA と GET_DATA のいずれかにできます。
event_date 日にち イベントが発生した UTC の日付。
event_time timestamp イベントが発生したときの正確なタイムスタンプ。 タイムゾーン情報は、UTC を表す +00:00 という形式で値の末尾に記録されます。

リスティング ファネル イベント テーブル

リスト ファネル イベント テーブルでは、掲載に対して行われたインプレッションとアクションが分析されます。 event_type を見ると、コンシューマーがリスティングに対して行ったアクションがわかります。

テーブル パス: このシステム テーブルは、 system.marketplace.listing_funnel_eventsにあります。

列名 データ型 説明
account_id 文字列 リスティングをホストするアカウント ID。
metastore_id 文字列 一覧をホストするメタストア ID。
metastore_cloud 文字列 リスティングをホストするメタストアのクラウド プロバイダー。
metastore_region 文字列 リスティングをホストするメタストアのリージョン。
provider_id 文字列 プロバイダー プロファイル ID。
provider_name 文字列 プロバイダー プロファイル名。
listing_id 文字列 リスティング ID。
listing_name 文字列 リスティング名。
event_type 文字列 コンシューマー アクションの種類。 「イベントの種類」をご覧ください。
event_time timestamp イベントが発生したときの正確なタイムスタンプ。 タイムゾーン情報は、UTC を表す +00:00 という形式で値の末尾に記録されます。
event_date 日にち イベントが発生した UTC の日付。
consumer_cloud 文字列 コンシューマーのクラウド。 consumer_delta_sharing_recipient_type が OPEN である場合、Null 許容です。
consumer_region 文字列 コンシューマーのリージョン。 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 システム テーブルを分析する

次のノートブックには、この記事のクエリの例と共に、それ以外の分析を提供する追加のセルが含まれています。

Marketplace システム テーブルのデモ

ノートブックを入手

  • Last updated on