创建、联接、移除和卸载 Clean Room

本页介绍如何创建基本 Clean Room、联接您受邀联接的 Clean Room、删除您创建的 Clean Room 或移除您作为使用者联接的 Clean Room。

创建新的 Clean Room

您必须在 Snowflake 账户中拥有适当的权限才能创建 Clean Room。Clean Room 创建者称为 provider

借助 Web 应用程序程序中的 Clean Rooms 页面,您可以作为提供商管理 Clean Room 的生命周期,包括创建和共享。如果您无权访问 Clean Room Web 应用程序,请与您的 Snowflake 账户的 Clean Room 管理员联系。

要创建和共享 Clean Room,请执行以下操作:

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

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

  3. 选择 + Clean Room。创建过程包括以下步骤:

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

    2. 使用 Specify Join Policies 步骤启用由 Clean Rooms 账户管理员启用的身份提供商并选择使用者可以联接的列。

    3. 使用 Configure Analysis & Query 步骤定义 Clean Room 中可用的模板、特定于模板的配置设置以及其他功能(如激活和隐私设置)。

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

有关在 Clean Room UI 中创建新 Clean Room 的完整演示,请尝试 Clean Room Web 应用程序教程

备注

您可以在一个账户中创建的(Clean Room + 协作者)数量是有限的。如果您创建的测试 Clean Room 过多,则可能需要删除一些才能创建新的 Clean Room。如果您需要的 Clean Room 数量超出账户容量,请联系 Snowflake 支持部门

安装(联接)Clean Room

如果您受邀联接 Clean Room,您将收到一封电子邮件,其中包含一个链接,用于在 Clean Room UI 中安装、配置和运行 Clean Room。您可以点击链接并使用 Clean Room UI,或者使用代码安装并运行 Clean Room。

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

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

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

  3. Invited 选项卡上,找到 Clean Room 并选择 Join。当您被添加为 Clean Room UI 中的协作者时,您应该在邀请电子邮件中获得指向此页面的直接链接。

  4. 选择要用于协作处理提供商数据的表,然后选择 Next

  5. 选择您的 Clean Room 环境中需要在此 Clean Room 中使用的任何可用身份提供商。

  6. 指定表中的哪些列可以联接,以及提供商数据中的相应列。

  7. 选择 Next

  8. 为分配给 Clean Room 的任何模板提供特定于模板的设置。

  9. 点击 Finish,可以选择立即运行模板,或计划重复运行该模板。

备注

部分 Clean Room 在您尝试联接时会出现以下错误:

Application role `SAMOOHA_BY_SNOWFLAKE.DCR_DELEGATED_CLEANROOM_ROLE` does not exist
or not authorized.

如果您遇到此错误,请运行以下代码并尝试再次联接 Clean Room:

USE ROLE ACCOUNTADMIN;
CALL SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.PREPARE_MOUNT_SCRIPT();
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;
Copy

删除您创建的 Clean Room

删除后,共享用户下次打开 Clean Room Web 应用程序时,他们将无法再看到 Clean Room。如果在删除 Clean Room 时分析正在进行中,则在删除 Clean Room 之前分析可能无法完成。

要使用 Clean Room UI 删除您创建的 Clean Room,请执行以下操作:

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

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

  3. 在要删除的 Clean Room 中,选择 更多三个垂直点表示更多选项):ui:> Delete

卸载(取消联接)Clean Room

您可以卸载作为使用者安装(联接)的 Clean Room。这将卸载账户中所有用户的 Clean Room。

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

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

  3. 导航到 Clean Rooms » Joined

  4. 在要卸载的 Clean Room 中,选择 更多三个垂直点表示更多选项):ui:> Leave

向 Clean Room 中添加表从中移除表

以下是向 Clean Room 中添加表从中移除表(“链接”或“取消链接”):

使用 UI 时,只能将管理员注册的表或视图联接到 Clean Room。如果您找不到可在 Clean Room 中使用的表或视图,请让管理员在您的账户中注册该对象。

  • 作为提供商,您可以在创建或编辑 Clean Room 的 Add Data 步骤中选择要链接到 Clean Room 的表。

  • 作为使用者,您可以在联接或编辑 Clean Room 时选择在 Add Data 步骤中将哪些表链接到 Clean Room。

将表添加到 Clean Room 中后,就无法将其从该 Clean Room 中移除。但是,您可以从整个账户中移除数据。如果您需要从 Clean Room 移除表或视图,请咨询您的 Clean Room 管理员。

语言: 中文