在 Web 应用程序中使用 Snowflake Data Clean Rooms

Snowflake Data Clean Room 的 Web 应用程序 提供了直观的 UI,允许企业用户创建和使用 Clean Room,而不必担心代码的复杂性。

本主题介绍了您在处理 Clean Room 时您完成的任务。它描述了创建和共享 Clean Room 的提供商以及使用该 Clean Room 的使用者的操作。

作为提供商创建 Clean Room

借助 Web 应用程序程序中的 Clean Rooms 页面,您可以作为提供商管理 Clean Room 的生命周期,包括创建和共享。要创建和共享 Clean Room,请执行以下操作:

  1. 在 Web 应用程序 中登录 Clean Room 环境。

  2. 在左侧导航栏中,选择 Clean Rooms

  3. 选择 + Clean Room。创建过程包含 4 个步骤:

    1. 按照 Add Data 步骤命名 Clean Room 并选择与使用者共享的表。名称最多可以为 80 个字符,不区分大小写,包含 a-z、0-9、空格和下划线。

    2. 按照 Specify Join Policies 步骤使用第三方数据增强数据,并选择使用者可以连接哪些列。

    3. 按照 Configure Analysis & Query 步骤定义使用者可以在 Clean Room 中执行哪些分析,并选择他们可以在分析中使用的表和列。

    4. 按照 Share Clean Room 步骤邀请使用者使用 Clean Room 进行协作。您还可以使用 Enable Run Analysis & Query 选项来指定哪些协作者可以在 Clean Room 中运行分析。

作为提供商运行分析

提供商可以配置 Clean Room,以便在 Clean Room 中进行自己的分析。在设置 Clean Room 以运行提供商分析时,提供商可以指定使用者是否也可以在 Clean Room 中运行分析。如果提供商指定使用者不能运行分析,使用者仅作为 Clean Room 中的数据提供商。

提供商在创建 Clean Room 的 Share Clean Room 阶段使用 Enable Run Analysis & Query 选项来指定谁可以运行分析。为了配置 Clean Room,以便提供商可以运行分析,提供商为他们自己的账户开启此选项,该账户与使用者一起列出。

当提供商想要运行分析时,他们可以执行以下操作之一:

  • 从左侧导航中选择 Clean Rooms,在 Created 选项卡中找到 Clean Room 的磁贴,然后选择 Run

  • 从左侧导航中选择 Analyses & Queries,并运行现有分析或创建一个新分析,就像使用者一样。

对于两种启动分析的方法,提供商可以选择哪个协作者拥有他们想要包含在分析中的数据。

重要

如果使用者允许提供商对模板运行分析,则由使用者而不是提供商为提供商分析所消耗的 credit 付费。在使用者允许提供商运行分析后,使用者必须卸载 Clean Room 以停止产生费用。

如果使用者想要获取提供商在特定时间段内使用的 credit 数量估值,他们可以执行以下查询,其中 -5 返回提供商过去 5 天的计算使用量估值:

SELECT * FROM table(samooha_by_snowflake_local_db_dev.public.udtf(-5));
Copy

如果您是希望监控提供商运行的分析的使用者,请参阅 监控由提供商运行的分析

将提供商运行的分析结果推送到 Snowflake 账户

提供商可以将提供商所运行分析的结果推送到 Snowflake 账户,以便在那里用于激活。

重要

如果使用者向为提供商所运行分析配置的 Clean Room 贡献数据,则必须同意提供商将结果推送到提供商的 Snowflake 账户。要作为使用者提供此同意,请完成以下步骤:

  1. 开始 安装为提供商所运行分析配置的 Clean Room

  2. 继续安装过程,直到您到达 Configure Analysis & Query 步骤。

  3. Activation Settings 部分中,选择 Allow activation for clean room provider

要将提供商所运行分析的结果推送到 Snowflake 账户,请完成以下步骤:

  1. 在运行提供商所运行分析后,在 Results 部分选择 Activate

  2. 选择 Snowflake 账户名称。

  3. 选择 Push Data

有关查看推送数据何时在 Snowflake 账户中可用的信息,请参阅 在提供商的 Snowflake 账户中查看分析结果

提供商所运行分析的限制

在使用 Web 应用程序程序运行分析时,提供商有以下限制:

  • 并非所有模板都受支持。目前,支持 Audience Overlap & Segmentation 和 SQL 查询模板。

  • 如果协作者在不同的云或地区:

    • 使用者必须在账户上 启用 Cross-Cloud Auto-Fulfillment

    • 提供商所运行分析结果是根据双方的综合刷新频率返回的。提供商和使用者应该协调,以便提供商应用程序和使用者列表的刷新频率相似(例如,两者的频率均为 15 分钟)。这可确保结果及时返回。

作为使用者安装 Clean Room

借助 Web 应用程序中的 Clean Rooms 页面,您可以作为使用者安装已由提供商与您共享的 Clean Room。要安装 Clean Room,请执行以下操作:

  1. 在 Web 应用程序 中登录 Clean Room 环境。

  2. 在左侧导航栏中,选择 Clean Rooms

  3. Invited 选项卡上,找到 Clean Room 并选择 Join

  4. 选择要用于处理提供商数据的表。

  5. 使用 Join Policies 字段定义您的数据与提供商数据之间的关系。

  6. 选择 Next

作为使用者运行分析

作为使用者,您可以使用 Clean Rooms 页面或 Analyses & Queries 页面在安装的 Clean Room 中运行分析。

要使用 Clean Rooms 页面根据提供商在 Clean Room 提供的分析类型运行新的分析,请执行以下操作:

  1. 在 Web 应用程序 中登录 Clean Room 环境。

  2. 在左侧导航栏中,选择 Clean Rooms

  3. Joined 选项卡上,在列表中找到 Clean Room 并选择 Run

  4. 选择分析类型,然后选择 Proceed

  5. 在分析中添加筛选器。筛选值可能不可用的原因有两个:

    • 该列包含超过 20 个不同的值。

    • Clean Room 最近安装完成,尚未处理完该列的预览值。当这些值可用时,您可以重新运行分析。

  6. 选择 Run

  7. 可选:展开 Save Analysis & Query 部分以保存分析以备将来使用。

要使用 Analyses & Queries 页面运行现有分析或创建和运行新分析,请执行以下操作:

  1. 在 Web 应用程序 中登录 Clean Room 环境。

  2. 在左侧导航栏中,选择 Analyses & Queries

  3. 执行下列操作之一:

    • 要运行现有的分析,请使用筛选器查找该分析并运行它。

    • 要根据提供商在 Clean Room 提供的分析类型创建和运行新的分析,请选择 + New Analysis & Query

选择仓库以运行分析

您可以选择要使用哪个 仓库 来运行分析。增加仓库的大小或更改类型可以加快分析速度。

备注

模板的类型决定了您可以选择哪种类型的仓库运行分析。例如,一些模板(如 Audience Overlap)仅允许常规仓库,而另一些模板(如 Audience Lookalike Modeling)仅允许 Snowpark-Optimized Warehouses。

用以选择不同仓库的选项显示在模板上的 Run 按钮旁边。此选项并非适用于所有模板。

请注意,增加仓库的大小或使用 Snowpark-Optimized Warehouse 可能会增加运行分析的成本。有关如何随着您使用更大仓库而增加 Credit 使用量的信息,请参阅 仓库规模Snowpark-Optimized Warehouses 的计费

有关可用仓库的描述,请参阅 仓库

如果您是想创建额外仓库选项的管理员,请参阅 添加仓库选项

查看有关 Clean Room 的详细信息

您可以获得有关 Clean Room 的详细信息,包括:

  • Collaborator Summary 选项卡,列出了 Clean Room 中的模板,以及协作者的表和联接列。

  • My Summary 选项卡,列出了表和联接列。

  • Table Relations 选项卡,列出了您的表和协作者的表之间的关系(即,表是如何联接的)。

  • Data Stats 选项卡,提供了表的以下指标:

    • 我的表: 显示属于某个组的不同标识符的数量。请注意,统计信息每 24 小时更新一次,因此在修改 Clean Room 和查看更新的统计信息之间可能会有延迟。请注意,具有超过 20 个不同值的列未显示。

    • 重叠统计信息: 无论 Clean Room 具有 Audience Overlap & Segmentation 还是 SQL 查询模板,都将向使用者显示重叠统计信息。这些统计信息描述了基于模板中启用的属性列,属于某个特定组的不同标识符(联接列)的数量。您最多可以选择 2 个属性列以查看统计信息细分。数据是在初始安装后生成的,并在用户登录 Clean Room Web 应用程序时刷新。请注意,在条形图可视化中,仅根据提供的默认排序绘制了前 5 行数据。对于特定细分,运行时间超过 10 分钟的统计信息将不可用。

要访问这些 Clean Room 的详细信息,请完成以下步骤:

  1. 在 Web 应用程序 中登录 Clean Room 环境。

  2. 在左侧导航栏中,选择 Clean Rooms

  3. 点击 Clean Room 的磁贴。

在运行分析时,Clean Room 的详细信息也可在 Clean Rooms Details 部分找到。

下载并分享结果

希望在 Clean Room 内共享他们生成的汇总结果的用户可以将 Clean Room 分析的结果下载为 .csv 文件,然后与 Snowflake 之外的其他人共享这些结果,包括通过电子邮件与 Clean Room 协作者共享。

语言: 中文