将 Clean Room UI 更新到 Snowflake 身份验证¶
重要
如果您是在 5 月 1 日之后安装的 Snowflake Data Clean Rooms 应用程序，则无需阅读这篇文章。
- 问题
在 5 月 1 日之前，用户使用其 Clean Room 凭据登录 Clean Room UI。5 月 1 日，Snowflake 身份验证成为新 Clean Room UI 安装中使用的默认凭据，但不适用于以前的安装。
- 解决方案
在 5 月 1 日之前安装了 Clean Room UI 的管理员需要在 2025 年 7 月底之前迁移其 Clean Room 账户，以便开始使用 Snowflake 身份验证。该操作通过一个小巧简单的向导即可完成，该向导会在您使用具有管理员权限的账户登录 Clean Room 时出现。
向导将引导您完成三个简单步骤：
1.下载您当前的 UI 用户列表¶
下载当前 UI 用户列表。如果有任何用户不同时是 Snowflake 用户，则会在列表中注明。您需要授予他们访问 Snowflake 账户的权限，否则他们将无法再访问该账户中的 Clean Room UI。（在变更之前，如果 Clean Room 管理员邀请您，那么您可以在没有 Snowflake 账户的情况下访问 Clean Room UI。）
该报告包括以下字段：
Email：与用户账户关联的电子邮件地址。Users on Snowflake：在 Snowflake 上与此电子邮件关联的用户名。如果有多个用户与此电子邮件相关联，则所有用户都将显示在此处。请注意，切换身份验证后，只有第一个使用此电子邮件登录 UI 的用户才能在 Analyses & Queries 页面中看到之前的查询结果。如果有多个用户，而您需要更改谁能看到查询结果，请联系 Snowflake 支持部门Name：用户的名字和姓氏（基于其 Snowflake 个人资料）。DCR role：该用户在 DCR UI 中的现有角色，其中 Admin` 映射到 MANAGE_DCR_PROFILE_AND_FEATURES、MANAGE_DCR_CONNECTORS，而 MANAGE_DCR_COLLABORATORS 和 Clean room manager 映射到 MANAGE_CLEANROOMS。查看 Clean Room 角色的完整列表。
您可以在 Snowsight 的 Snowflake 个人资料 中看到您的电子邮件、用户名、名字和姓氏。
备注
如果您用户的 Clean Room UI 电子邮件与其 Snowflake 账户电子邮件不完全匹配，或者多个用户使用相同的电子邮件地址，他们可能会 遇到问题。
2.测试您的访问权限¶
要测试您是否可以使用您的 Snowflake 凭据打开 Clean Room UI，请选择 Test Login 并为任何应该能够访问该 Clean Room UI 的账户提供 Snowflake 凭据。
3.迁移¶
将您账户的 Clean Room UI 登录方式切换为 Snowflake 身份验证。至此，全部完成！现在，Clean Room UI 的登录流程应与 Snowsight 和 Clean Room UI 相同。如果您使用的是 SSO，则无需采取任何特殊步骤。
请注意，您必须在 7 月底之前切换 Clean Room UI 以使用 Snowflake 身份验证。
分析和查询历史记录迁移详情¶
如果您在登录 Clean Room UI 后看不到 Clean Room 报告历史记录，则可能的原因如下：
迁移后首次登录时，将为 Clean Room 账户迁移报告。如果您最初未看到报告，请稍等片刻，查看报告是否会出现在您的 Clean Room 账户中。
对于现在与您的 Clean Room 账户关联的 Snowflake 电子邮件地址，您尚未验证其所有权。如果是这种情况，请在 Snowflake 中 验证您的电子邮件地址。
如果多个用户在旧的 Clean Room UI 中引用了相同的 Snowflake 电子邮件，则只有迁移后第一个登录 Clean Room UI 的用户才能访问这些报告。如果您需要将报告切换给其他用户，请联系 Snowflake 支持部门。
以下是有关迁移过程的更多详细信息：
Clean Room UI 以前使用电子邮件地址作为用户凭据。迁移后，Clean Room UI 使用 Snowflake 用户 IDs。迁移 Clean Room 报告时，系统会尝试找到旧的 Clean Room 电子邮件地址与 Snowflake 用户 ID 电子邮件地址之间的精确匹配项。
迁移后，每位用户在首次登录 Clean Room UI 时，只要满足以下条件，其查询报告历史记录就会与 Snowflake 电子邮件相关联：
用户在 Snowflake 上的电子邮件与在 Clean Room UI 中使用的相同
用户的电子邮件在 Snowflake 中经过验证。
如果用户没有 Snowflake 电子邮件，或者 Snowsight 电子邮件未经过验证，则报告不会迁移过来。