Clean Room UI 导览¶
本主题向您介绍 Clean Room UI 的主页和元素,以及如何将它们用于常见任务。
对于您而言,Clean Room UI 的外观可能与此处显示的略有不同,因为 Clean Room UI 会定期更新,而且对于未 升级为使用 Snowflake 身份验证 的账户用户,Clean Room UI 的外观也有所不同。此外,某些页面要求您具有 特定的 Clean Room 角色 才能访问。如果您没有相应的角色来访问页面,则该页面可能被禁用或无法出现在您的 Clean Room UI 中。使用 ACCOUNTADMIN 角色可以访问此处描述的所有页面。
要在浏览器中跟随操作,请登录 Clean Room UI。
Clean Room 库存页面¶
登录后看到的登录页面是 Clean Room 库存页面。在这里,您可以看到您创建、加入或受邀加入但尚未加入的所有 Clean Room。
- 1) Navigation bar:
使用导航栏转到其他 Clean Room 页面,如本主题其他部分所述。
- 2) Clean room list:
Clean Room 分为您创建的、您以使用者身份加入(安装)的以及您作为使用者受邀加入的 Clean room。您可以通过在列表上方的筛选器文本框中输入完整或部分字符串来筛选当前视图中的列表。
每个图块都显示 Clean Room 名称、合作者、创建或上次编辑 Clean Room 的时间,以及一个用于启动该 Clean Room 主要操作的按钮,如下所述。
Clean Room 分为以下选项卡:
Created 选项卡:显示您使用 UI 或 API 创建的 Clean Room。将使用 API 创建的 Clean Room 标记为 Supported with Developer APIs。
若某个图块在 Created 列表中显示 Run 按钮,则表示该 Clean Room 已启用 提供商主导分析功能。
Joined 选项卡:显示您已通过 UI 或 API *加入*(作为使用者安装)的 Clean Room。加入 Clean Room 后,您必须进行配置以关联自己的数据集、设置连接和列策略,并提供该 Clean Room 内特定分析或模板所需的任何其他值。
配置已加入的 Clean Room 后,您可以通过选择 Run 按钮在已加入的 Clean Room 中运行分析,或使用 |sf-vertical-more-button|(更多)列表选项来编辑您的值、将 Clean Room 重置为原始值或离开(卸载)Clean Room。有关更多信息,请参阅 安装(加入)Clean Room 或 删除您创建的 Clean Room。
Invited 选项卡:显示邀请您以使用者身份加入的 Clean Room。要加入 Clean Room,请选择 Join 按钮。加入(安装)Clean Room 可能需要几分钟。加入后,Clean Room 将从 Invited 视图移至 Joined 视图。然后,您必须配置 Clean Room,以便可以在该 Clean Room 中进行任何分析。
重要
如果 Clean Room 是使用 API 创建的(标记为 Supported with Developer APIs),则该 Clean Room 仅当其明确设计用于 UI 时,才能在 UI 中使用。否则,您使用 API 创建的 Clean Room 仅可在 API 中使用。
要查看可供您在 UI 中使用的任何模板,请选择 Run。UI 模板列在 Select Analysis / Query 列表中;Developer API Templates 部分中列出的模板只能使用 API 运行。
- 3) Clean room creation button:
选择此按钮创建新的 Clean Room。有关更多信息,请参阅 创建新的 Clean Room。
- 4) Account information:
使用此小组件可查看 Snowflake 隐私政策信息、基本账户信息,或在 Clean Room UI 中注销此账户。如需更详细的配置文件信息,请打开 Profile & Features 页面。
分析和查询列表页面¶
此页面显示该账户在 Clean Room UI 中进行的分析的历史记录。此处未显示使用 API 运行的分析。您还可以使用此页面在现有 Clean Room 中对指定类型进行新的分析。
要查看给定分析的结果,请从列表中选择分析并按 分析结果页面 中所述检查结果。列表中的每个元素都显示分析名称、状态以及在哪个 Clean Room 中运行分析。
您可以通过选择 New Analysis & Query 来运行给定类型的新分析。选择要运行的分析类型,系统将显示支持该分析类型的 Clean Room 列表,随后即可配置并运行分析。
分析结果页面¶
分析结果页面显示单个分析的配置和结果。下图显示了一个计划每日运行的无标题“重叠与分段分析”的结果。
分析结果显示在页面的 Results 部分中;您可能需要向下滚动才能看到它们。一些分析显示了简化的结果图,可通过选择 Download 下载完整的表格结果。如果分析启用了激活功能,请选择 Activate 并 完成激活流程,以指定哪些对象应获取完整结果。
该页面还会在 Query Configurations 部分显示分析的详细信息。您可以修改这些值,然后选择 Run 再次运行分析。
此页面包含在 Analysis & Queries 列表页面的所有分析列表中。
要更改或禁用重复查询运行的计划,请将页面上的 Schedule Run 选择器更改为所需的运行计划,或选择 Off 以关闭重复运行。
配置文件和功能页面¶
此页面用于管理向协作者显示的公司名称和徽标,以及管理第三方 身份提供商、数据提供商 和 激活提供商 的列表。
使用此页面可管理为此账户 启用 的第三方提供商连接器列表;您 无需在此处配置 连接器或将其分配给特定 Clean Room。您可以在 Connectors 页面中配置连接器,并在 Clean Room 创建或编辑流程中启用各个 Clean Room 内的连接器。
此页面上的身份、数据和激活提供商连接器列表仅显示为此账户启用的连接器。要启用新连接器,请选择 Edit,然后选择要启用的连接器。在此处启用连接器后,必须在 Connectors 页面中对其进行配置。
您需要 SAMOOHA_BY_SNOWFLAKE.MANAGE_DCR_PROFILE_AND_FEATURES 应用程序角色才能访问此页面。
Snowflake 管理员页面¶
您可以在此页面上执行以下管理任务:
您的账户标识符。
查看账户云和区域。
查看并管理 UI 用于执行 Clean Room 操作的 服务用户。
查看和管理账户范围内的功能,例如 Cross-Cloud Auto-Fulfillment、外部和 Iceberg 表 以及定期重复分析。
注册数据对象 以在 Clean Room 中使用。
您需要 ACCOUNTADMIN 角色才能访问此页面。
协作者页面¶
使用此页面可管理可使用 Clean Room UI 邀请加入 Clean Room 的使用者列表。(Clean Room API 用户可以邀请任何拥有 Snowflake 账户的人。)仅此处列出的协作者可由 Clean Room 提供商在 UI 中邀请。
此页面包含独立板块,分别用于管理拥有 Snowflake 账户的协作者,以及管理无 Snowflake 账户的协作关系。(没有 Snowflake 账户的协作者使用 托管账户。)
您需要 SAMOOHA_BY_SNOWFLAKE.MANAGE_DCR_COLLABORATORS 应用程序角色才能访问此页面。
连接器页面¶
此页面用于配置在 Profile & Features 页面中启用的任何身份、数据或激活连接器。有关如何在 Clean Room 中配置提供商的信息,请参阅 Third-party connectors 部分下的文档。
您需要 SAMOOHA_BY_SNOWFLAKE.MANAGE_DCR_CONNECTORS 应用程序角色才能访问此页面。