安装 Snowflake Data Clean Rooms 环境¶

账户和用户要求¶

以下是在 Snowflake 账户中安装 Snowflake Data Clean Rooms 的要求：

• 账户必须是所需的 Snowflake 版本：

  • 要创建 Clean Room，您必须拥有 Enterprise Edition 或更高版本。

  • 为了能够联接和使用其他账户中创建的 Clean Room，您必须拥有 Standard Edition 或更高版本。

• 账户必须允许 密钥对身份验证，由服务账户用于进行身份验证。

• 您必须接受数据共享条款。 如果您尚未接受 Snowflake 客户控制的数据共享功能条款，请联系 Snowflake 支持团队。Snowflake Data Clean Room 利用 列表，这些列表是 Snowflake 服务的一部分，受您与 Snowflake 的服务条款的约束，包括 Snowflake 客户控制的数据共享功能条款和 Snowflake 可接受使用策略。

• 不得定义账户级默认值 排序规则。您可以运行以下命令检查您的排序规则状态：SHOW PARAMETERS LIKE 'DEFAULT_DDL_COLLATION' IN ACCOUNT;

• （仅限 Clean Room UI）**Snowflake 账户必须是容量账户：** 这是一个有预付容量承诺的账户。Snowflake On-Demand 账户无法访问 Clean Room UI。

• （仅限 Clean Room UI）**您必须使用 :ref:` 支持的身份验证器应用程序 <label-cleanroom_web_app_mfa>` 进行多重身份验证** (MFA)。

如果您不满足所有这些要求并需要升级，请联系 Snowflake 支持部门。

安装人员要求¶

以下是对 Clean Room 环境安装人员的要求：

• 您必须在 Snowflake 账户中拥有 ACCOUNTADMIN 角色，才能在该账户中安装 Clean Room 环境。

• 具有 ACCOUNTADMIN 角色的用户必须为其用户对象定义有效的名字、姓氏和电子邮件。要进行检查，请运行 DESCRIBE USER。

1.安装原生应用程序¶

通过代码或 Marketplace 安装原生应用程序：

如果您不想同意 Marketplace 提供商和使用者条款：

则在您的 Snowflake 账户中运行以下代码：

USE ROLE ACCOUNTADMIN;
CALL system$accept_legal_terms('DATA_EXCHANGE_LISTING', 'GZSTZTP0KKO');
CREATE APPLICATION SAMOOHA_BY_SNOWFLAKE FROM LISTING 'GZSTZTP0KKO';

Copy

如果您同意 Marketplace 提供商和使用者条款：

1. 则将您当前的角色设置为 ACCOUNTADMIN

2. 从 Snowflake Marketplace 安装 Snowflake Data Clean Room 应用程序

3. 选择 Get 并接受默认选项。

安装只需几分钟时间。

2. 安装 Clean Room API¶

Clean Room API 用于 Clean Room 的编程创建和使用。

以下是在您的 Snowflake 账户中安装 Clean Room API 的步骤：

1. 安装原生应用程序后，在 Snowflake 中启动它：Data products » Apps » Snowflake Data Clean Rooms » Launch app。这将打开一个包含 SQL 命令的工作表。

2. 运行 SQL 命令安装 Clean Room API 的注意事项如下：

   • 如果在安装过程中重命名了原生应用程序，则需要按照脚本注释中的说明修改脚本。

   • 如果想在运行前查看完整的安装脚本，请取消 DRY_RUN=TRUE 脚本行的注释，然后运行包括该行在内的所有命令，以查看脚本内容。请注意，不要手动运行该命令暴露的安装脚本，否则可能导致安装不完整。

   • 请注意，安装需要几分钟时间。

3. 确认可以访问 API：

   USE ROLE samooha_app_role;
   USE WAREHOUSE app_wh;
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.CHECK_MOUNT_STATUS();
   

   Copy

   如果返回 FALSE，请参阅下面的故障排除部分。

4. 向您 Snowflake 账户中的其他用户授予 API 访问权限：

   • 要添加具有 全部能力 的用户来创建和管理 Clean Room，请运行 GRANT ROLE SAMOOHA_APP_ROLE to USER USER

   • 要添加仅具有 使用者运行权限 的用户，请创建一个或多个 Snowflake 角色，并授予用户对该角色的访问权限。然后，通过调用 consumer.grant_run_on_cleanrooms_to_role，授予特定 Clean Room 的运行权限。

5. （可选）安装 Clean Room UI，实现无代码访问 Clean Room 或其他功能，如计划查询。

3.启用 Clean Room UI¶

Clean Room UI 提供了一个简单的无代码环境，用于管理 Clean Room 账户、创建 Clean Room 和运行分析。它还提供了一些 Clean Room API 中没有的 附加功能，如计划查询、第三方激活和有用的预定义模板。

以下是在您的 Snowflake 账户中启用 Clean Room UI 的方法：

1. 配置您的网络策略，以 允许 Clean Room UI 访问您的 Snowflake 账户。（仅在您的 Snowflake 账户使用网络策略控制网络流量时才需要）。

2. 创建一个服务用户。 该服务用户由 Clean Room UI 用来与 Snowflake 通信。

   1. 使用您的 Snowflake 管理员凭据登录 Snowsight，并创建一个服务用户，如下所示。提供您可以访问的密码和电子邮件地址。我们建议使用分发列表，而不是个人电子邮件。

      -- Create the service user account.
      
      USE ROLE USERADMIN;
      CREATE USER <SERVICE-USER-USERNAME> PASSWORD='<SERVICE-USER-PASSWORD>'
      FIRST_NAME='DCR' LAST_NAME='Service User'
      EMAIL='<SERVICE-USER-EMAIL-ADDRESS>';
      

      Copy

   2. 在 Snowsight 以外保存服务用户名和密码，因为在安装过程中会用到。

   3. 在 Snowsight 中退出当前用户，然后使用 服务用户的凭据 重新登录同一 Snowflake 账户。

   4. 打开配置文件，并选择 Resend verification email。

   5. 打开验证电子邮件，点击链接验证服务用户电子邮件地址。无需使用服务用户的凭据再次登录 Snowsight。您可以在 Admin » Snowflake Admin 页面 Snowflake 下方的 Clean Room UI 中查看服务用户的详细信息。

3. 完成 UI 设置。 本步骤将网络策略应用到服务用户，将服务用户从密码身份验证迁移到密钥对身份验证，并将 SAMOOHA_APP_ROLE 授予服务用户。请按照以下步骤完成 UI 的基本设置：

   1. 使用您的 Snowflake 凭据 登录 Clean Room UI。

   2. 打开 Admin » Snowflake Admin » Connect to Snowflake account。

   3. 输入您的服务账户用户名，然后选择 Save。

   4. 您现在可以使用 Clean Room UI。