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

プレビュー

この機能はパブリックプレビュー段階です。

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

Marketplace システム テーブルは、すべて system.marketplace スキーマ内にあります。 現在、次のテーブルが稼働しています。

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

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

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が REQUEST_DATAの場合に null されます。

consumer_delta_sharing_recipient_type

文字列

コンシューマーが Databricks アカウントを使用しているかどうか。 値は OPEN または DATABRICKSになります。

consumer_cloud

文字列

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

consumer_region

文字列

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

consumer_metastore_id

文字列

コンシューマーのメタストア ID。 consumer_delta_sharing_recipient_typeOPENの場合は null 許容です。

consumer_email

文字列

コンシューマーの電子メール アドレス。 PII.

consumer_name

文字列

コンシューマーの名前。 PII.

consumer_company

文字列

消費者の会社。

consumer_intended_use

文字列

消費者によるリスティングの使用目的。

consumer_comments

文字列

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

event_type

文字列

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

event_date

日付

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

event_time

タイムスタンプ

イベントが発生したときの正確な UTC タイムスタンプ。

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

listing_funnel_events表では、リスティングの表示回数とアクションが分析されます。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

タイムスタンプ

イベントが発生したときの正確な UTC タイムスタンプ。

event_date

日付

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

consumer_cloud

文字列

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

consumer_region

文字列

消費者の地域。 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 クラウドの消費者アクティビティは含まれていません。

  • 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 システムテーブル demo

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