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

  • [アーティクル]

重要

この機能はパブリック プレビュー段階にあります。

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

Marketplace システム テーブルは system.marketplace スキーマに従います。 以下のテーブルが利用できます。

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

Note

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

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

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

system.marketplace.listing_access_events のスキーマは次のとおりです。

列名 データ型 Description
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 コンシューマーが Azure 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 コンシューマーのメール アドレス。 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 という形式で値の末尾に記録されます。

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

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

system.marketplace.listing_funnel_events のスキーマは次のとおりです。

列名 データ型 Description
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 という形式で値の末尾に記録されます。
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 のシステム テーブルには、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 システム テーブルのデモ

ノートブックを入手