市场系统表引用

项目
10/19/2024

重要

此系统表为公共预览版。若要访问表，必须在 system 目录中启用架构。有关详细信息，请参阅启用系统表架构。

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

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

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

注意

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

列表访问事件表

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

表路径：此系统表位于 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 时间戳。时区信息记录在值的末尾，其中 `+00:00` 表示 UTC。

列表漏斗事件表

列表漏斗事件表分析对列表执行的印象和操作。 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 时间戳。时区信息记录在值的末尾，其中 `+00:00` 表示 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 天的消费者请求
按请求数排名靠前的列表
查看排名靠前的请求者
查看对列表执行的每个使用者操作的次数

过去 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

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

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

市场系统表演示

获取笔记本

通过