市场系统表引用

2025-06-11

重要

此系统表为公共预览版。

本页提供了有关如何使用系统表来帮助监视 Databricks 市场销售过程的参考。

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

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

注意

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

启用`marketplace`架构

帐户管理员必须启用 marketplace 架构。可以使用 system-schemas 或 SystemSchemas API 中的命令启用它。

启用市场平台架构

使用以下 CLI 命令启用 marketplace 架构：

databricks system-schemas enable METASTORE_ID marketplace

禁用市集架构

使用以下 CLI 命令禁用 marketplace 架构：

databricks system-schemas disable METASTORE_ID 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`	字符串	消费者的基础增量共享接收人名称。当 event_type 是 `null` 时，该值是 `REQUEST_DATA`。
`consumer_delta_sharing_recipient_type`	字符串	消费者是否使用了 Azure Databricks 帐户。值将是 `OPEN` 或 `DATABRICKS`。
`consumer_cloud`	字符串	使用者的云。如果 `consumer_delta_sharing_recipient_type` 为 `OPEN`，则可为空。
`consumer_region`	字符串	使用者的区域。如果 `consumer_delta_sharing_recipient_type` 为 `OPEN`，则可为空。
`consumer_metastore_id`	字符串	使用者的元存储 ID。如果 `consumer_delta_sharing_recipient_type` 为 `OPEN`，则可为空。
`consumer_email`	字符串	使用者的电子邮件地址。
`consumer_name`	字符串	使用者的名称。
`consumer_company`	字符串	面向消费者的公司
`consumer_intended_use`	字符串	使用者的预期列表用途。
`consumer_comments`	字符串	消费者留下的任何其他评论。
`event_type`	字符串	访问的类型。值可以是 `REQUEST_DATA` 或 `GET_DATA`。
`event_date`	日期	事件发生的 UTC 日期。
`event_time`	时间戳	事件发生时的确切 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`	时间戳	事件发生时的确切 UTC 时间戳。时区信息记录在值的末尾，其中 `+00:00` 表示 UTC。
`event_date`	日期	事件发生的 UTC 日期。
`consumer_cloud`	字符串	使用者的云。如果 `consumer_delta_sharing_recipient_type` 为 `OPEN`，则可为空。
`consumer_region`	字符串	使用者的区域。如果 `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

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

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

市场系统表演示

获取笔记本

通过