架构：

DATA_SHARING_USAGE

LISTING_EVENTS_DAILY 视图

通过 DATA_SHARING_USAGE 架构中的 LISTING_EVENTS_DAILY 视图，您可以查询 Snowflake Marketplace 和数据交换列表上的使用者活动日常历史记录，包括：

  • 使用者从列表中安装数据库。

  • 使用者安装 Snowflake Native App。

  • 使用者要求无限制访问受限试用列表或尚未提供数据的免费列表。

  • 使用者为付费列表或有限试用列表安装试用数据产品。

  • 使用者从 Snowflake Marketplace 购买付费列表。

  • 使用者决定不再将付费数据用于付费列表。

  • 使用者卸载 Snowflake Native App 或删除导入的数据库。

该视图包括特定列表的使用者活动历史记录。

列

列名称

数据类型

描述

EVENT_DATE

DATE

事件日期。

EXCHANGE_NAME

VARCHAR

列表所属的数据交换的名称，例如 Snowflake Marketplace。

EVENT_TYPE

VARCHAR

其中之一：

  • GET：使用者为免费列表创建数据库，或安装 Snowflake Native App。

  • REQUEST：使用者在尚未提供数据的区域要求受限试用列表或免费列表。

  • TRIAL：使用者创建试用数据库或安装试用版 Snowflake Native App。

  • PURCHASE：使用者同意在查询付费列表中的付费数据时收到发票。

  • CANCEL PURCHASE：使用者决定停止使用付费列表中的付费数据。

  • UNINSTALL：用户卸载 Snowflake Native App 或删除已导入的数据库。

SNOWFLAKE_REGION

VARCHAR

发生 REQUEST 或 GET 事件的 Snowflake 区域。

LISTING_NAME

VARCHAR

列表的标识符。

LISTING_DISPLAY_NAME

VARCHAR

列表的显示名称。

LISTING_GLOBAL_NAME

VARCHAR

列表的全局名称。每个列表名称都是唯一的，可用于创建列表 URL。

CONSUMER_ACCOUNT_LOCATOR

VARCHAR

使用者账户的账户定位器。有关账户标识符的更多信息，请参阅 账户标识符。

CONSUMER_ACCOUNT_NAME

VARCHAR

使用者账户名称。

CONSUMER_ORGANIZATION

VARCHAR

使用者账户的组织名称。

CONSUMER_EMAIL

VARCHAR

使用者账户的电子邮件地址（如有）。

TERMS_ACCEPTED_DATE

DATETIME

使用者接受列表条款时的时间戳。

CONSUMER_METADATA

VARIANT

使用者在事件发生时提供的其他信息，如姓名或使用免费电子邮件地址的原因。

REGION_GROUP

VARCHAR

使用者账户所在的 区域组。

CONSUMER_NAME

VARCHAR

包含访问、使用或请求列表的使用者账户的公司名称。如果没有可用的名称（例如试用账户），则该值为 NULL。

使用说明

  • 视图的延迟时间最长可达 2 天。

  • 数据会保留 365 天（1 年）。

  • 视图包含所有数据产品的数据，无论您的数据产品是 Snowflake Native App 还是共享。

示例

显示按列表分列的每日获取和请求计数：

SELECT
  listing_name,
  listing_display_name,
  event_date,
  event_type,
  SUM(1) AS count_gets_requests
FROM snowflake.data_sharing_usage.listing_events_daily
GROUP BY 1,2,3,4
Copy
语言: 中文