通过

市场系统表引用

  • 项目

重要

此功能目前以公共预览版提供。

本文概述了如何使用系统表来帮助操作你的 Databricks 市场销售过程。

市场系统表位于 system.marketplace 架构中。 以下表可用：

  • 列表访问：记录列表上已完成的请求数据或获取数据事件的使用者信息。
  • 漏斗事件：记录对列表的印象和执行的操作。

注意

可以使用提供程序分析仪表板监视收件人使用情况指标。 仪表板从市场系统表中拉取数据。 请参阅使用仪表板监视列表使用指标。

列表访问事件表

此 listing_access_events 表会检索列表上已完成的请求数据或获取数据事件的使用者信息。

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 消费者的基础增量共享接收人名称。 当 event_type 是 REQUEST_DATA 时，该值是 null。
consumer_delta_sharing_recipient_type string 消费者是否使用了 Azure Databricks 帐户。 值将是 OPEN 或 DATABRICKS。
consumer_cloud string 消费者的云。 如果 consumer_delta_sharing_recipient_type 为 OPEN，则可为空。
consumer_region string 消费者的区域。 如果 consumer_delta_sharing_recipient_type 为 OPEN，则可为空。
consumer_metastore_id string 消费者的元存储 ID。 如果 consumer_delta_sharing_recipient_type 为 OPEN，则可为空。
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 date 事件发生的 UTC 日期。
event_time timestamp 事件发生时的确切 UTC 时间戳。

列表漏斗事件表

listing_funnel_events 表会分析对列表的印象和执行的操作。 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 timestamp 事件发生时的确切 UTC 时间戳。
event_date date 事件发生的 UTC 日期。
consumer_cloud string 消费者的云。 如果 consumer_delta_sharing_recipient_type 为 OPEN，则可为空。
consumer_region string 消费者的区域。 如果 consumer_delta_sharing_recipient_type 为 OPEN，则可为空。

事件类型

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 日起，市场系统表包含使用 Google Cloud 上的 Databricks 的使用者活动。 在此日期之前，表不包含 Google Cloud 使用者活动。
  • 在 listing_funnel_events 表中，2023 年 11 月 30 日之前未记录 ABANDON_FAIL_DATA 和 FAIL_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

笔记本演示：分析市场系统表

以下笔记本包含本文中的示例查询以及提供进一步分析的其他单元格。

市场系统表演示

获取笔记本