在 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,请执行以下操作:
在 Web 应用程序 中登录 Clean Room 环境。
在左侧导航栏中,选择 Clean Rooms。
选择 + Clean Room。创建过程包含 4 个步骤:
按照 Add Data 步骤命名 Clean Room 并选择与使用者共享的表。名称最多可以为 80 个字符,不区分大小写,包含 a-z、0-9、空格和下划线。
按照 Specify Join Policies 步骤使用第三方数据增强数据,并选择使用者可以连接哪些列。
按照 Configure Analysis & Query 步骤定义使用者可以在 Clean Room 中执行哪些分析,并选择他们可以在分析中使用的表和列。
按照 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));
如果您是希望监控提供商运行的分析的使用者,请参阅 监控由提供商运行的分析。
将提供商运行的分析结果推送到 Snowflake 账户¶
提供商可以将提供商所运行分析的结果推送到 Snowflake 账户,以便在那里用于激活。
重要
如果使用者向为提供商所运行分析配置的 Clean Room 贡献数据,则必须同意提供商将结果推送到提供商的 Snowflake 账户。要作为使用者提供此同意,请完成以下步骤:
继续安装过程,直到您到达 Configure Analysis & Query 步骤。
在 Activation Settings 部分中,选择 Allow activation for clean room provider。
要将提供商所运行分析的结果推送到 Snowflake 账户,请完成以下步骤:
在运行提供商所运行分析后,在 Results 部分选择 Activate。
选择 Snowflake 账户名称。
选择 Push Data。
有关查看推送数据何时在 Snowflake 账户中可用的信息,请参阅 在提供商的 Snowflake 账户中查看分析结果。
提供商所运行分析的限制¶
在使用 Web 应用程序程序运行分析时,提供商有以下限制:
并非所有模板都受支持。目前,支持 Audience Overlap & Segmentation 和 SQL 查询模板。
如果协作者在不同的云或地区:
使用者必须在账户上 启用 Cross-Cloud Auto-Fulfillment。
提供商所运行分析结果是根据双方的综合刷新频率返回的。提供商和使用者应该协调,以便提供商应用程序和使用者列表的刷新频率相似(例如,两者的频率均为 15 分钟)。这可确保结果及时返回。
作为使用者安装 Clean Room¶
借助 Web 应用程序中的 Clean Rooms 页面,您可以作为使用者安装已由提供商与您共享的 Clean Room。要安装 Clean Room,请执行以下操作:
在 Web 应用程序 中登录 Clean Room 环境。
在左侧导航栏中,选择 Clean Rooms。
在 Invited 选项卡上,找到 Clean Room 并选择 Join。
选择要用于处理提供商数据的表。
使用 Join Policies 字段定义您的数据与提供商数据之间的关系。
选择 Next。
作为使用者运行分析¶
作为使用者,您可以使用 Clean Rooms 页面或 Analyses & Queries 页面在安装的 Clean Room 中运行分析。
要使用 Clean Rooms 页面根据提供商在 Clean Room 提供的分析类型运行新的分析,请执行以下操作:
在 Web 应用程序 中登录 Clean Room 环境。
在左侧导航栏中,选择 Clean Rooms。
在 Joined 选项卡上,在列表中找到 Clean Room 并选择 Run。
选择分析类型,然后选择 Proceed。
在分析中添加筛选器。筛选值可能不可用的原因有两个:
该列包含超过 20 个不同的值。
Clean Room 最近安装完成,尚未处理完该列的预览值。当这些值可用时,您可以重新运行分析。
选择 Run。
可选:展开 Save Analysis & Query 部分以保存分析以备将来使用。
要使用 Analyses & Queries 页面运行现有分析或创建和运行新分析,请执行以下操作:
在 Web 应用程序 中登录 Clean Room 环境。
在左侧导航栏中,选择 Analyses & Queries。
执行下列操作之一:
要运行现有的分析,请使用筛选器查找该分析并运行它。
要根据提供商在 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 的详细信息,请完成以下步骤:
在 Web 应用程序 中登录 Clean Room 环境。
在左侧导航栏中,选择 Clean Rooms。
点击 Clean Room 的磁贴。
在运行分析时,Clean Room 的详细信息也可在 Clean Rooms Details 部分找到。