Marketplace 系統資料表參考

文章
10/19/2024

重要

此系統資料表處於公開預覽狀態。若要存取資料表，必須在system目錄啟用結構描述。如需詳細資訊，請參閱啟用系統資料表結構描述。

本文提供如何使用系統資料表來協助運作 Databricks Marketplace 銷售流程的概觀。

Marketplace 系統資料表位於 system.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 共用收件者名稱。當 event_type 為 `REQUEST_DATA` 時，值為 `null` 。
`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`	字串	取用者電子郵件地址。 PII
`consumer_name`	字串	取用者的名稱。 PII
`consumer_company`	字串	消費者的公司。
`consumer_intended_use`	字串	取用者的預定清單用途。
`consumer_comments`	字串	取用者留下的任何其他評論。
`event_type`	字串	存取類型：這個值可以是 `REQUEST_DATA` 或 `GET_DATA`。
`event_date`	date	事件發生的 UTC 日期。
`event_time`	timestamp	事件發生的確切 UTC 時間戳記。時區資訊記錄在數值的末尾，其中 `+00:00` 代表 UTC。

列出漏斗圖事件資料表

清單漏鬥事件數據表會分析對清單所採取的印象和動作。 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` 代表 UTC。
`event_date`	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 資料表，2023 年 11 月 30 日之前沒有記錄 ABANDON_FAIL_DATA 和 FAIL_GET_DATA 的事件類型

查詢範例

本節包含下列範例查詢，可用來深入了解清單上的取用者活動。

過去 10 天內的取用者請求
按請求數量排名靠前的清單
檢視最熱門的請求者
查看每個取用者對清單執行動作的次數

過去 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 系統資料表示範

取得筆記本

分享方式：