教程：使用 Clean Room UI 和两个账户创建并运行 Clean Room¶

简介¶

Clean room 允许用户与协作者共享数据，同时通过严格控制使用数据可以做的事情来维护数据的隐私。本教程将引导您完成使用 Clean Room UI 与两个测试账户处理 Snowflake Data Clean Room 的基本流程，实现 Clean Room 的全部功能。如果只能访问一个已安装 Clean Room 的 Snowflake 账户，您可以改为尝试单账户教程。

您将学习以下内容¶

在本教程中，您将学习如何通过执行以下任务来使用 Clean Room UI：

在您的 Clean Room 环境中添加协作者。
创建 Clean Room，包括如何添加数据、指定联接策略、定义协作者可以对数据运行哪种类型的分析，以及如何与协作者共享 Clean Room。
安装 Clean Room，添加数据和定义如何将这些数据与协作者的数据结合起来。
运行分析。
激活分析结果。

关于 Clean Room 协作者¶

Clean Room 协作者要么是提供商，要么是使用者：

提供商 是创建和配置 Clean Room 的账户。在典型的 Clean Room 中，提供商添加使用者可以在 Clean Room 中运行的所有 SQL 模板。提供商添加数据，对其设置使用限制，并邀请可以加入 Clean Room 的使用者运行模板。
使用者 是受邀参与 Clean Room 的账户。使用者根据提供商设置的限制添加自己的数据，并在 Clean Room 数据上运行模板。

先决条件¶

您必须有权访问已安装 Snowflake Data Clean Room UI 的两个 Snowflake 环境：一个作为提供商使用，另一个作为使用者使用。您必须自行安装这些环境，或要求管理员授予您对 Snowflake 账户中 Clean Room UI 的访问权限.
This tutorial uses a sample table named CUSTOMERS_2. Either search Snowsight for the table SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS_2, or run the following SQL command in your Snowflake account to confirm that you have this table installed:
```
SHOW TABLES LIKE 'CUSTOMERS_2' IN SCHEMA SAMOOHA_SAMPLE_DATABASE.DEMO;
```
Copy
如果响应中没有行，则您或具有 ACCOUNTADMIN 角色的人必须运行以下命令来安装示例表：
```
USE ROLE ACCOUNTADMIN;
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;
```
Copy

提供商：登录 Clean Room UI¶

登录到 Clean Room，您将在其中以提供商的身份创建、配置和共享 Clean Room。

登录到 Clean Room UI。为将作为提供商的账户提供您的 Snowflake 账户凭据。

提供商：将使用者添加为协作者¶

在本节中，您将添加您在本教程中使用的使用者账户作为协作者。管理员必须先将某人定义为协作者，然后其他用户才能与该协作者共享 Clean Room。

要将使用者添加为协作者，请执行以下操作：

在左侧导航栏中，选择 Collaborators。
选择 Snowflake Partners 选项卡。
选择 + Snowflake Partner。
在 Company Name 字段中，输入 Tutorial Consumer。
在 Email Address 字段中，输入与您的 Clean Room 用户关联的电子邮件。
在 Account Locator 字段中，输入您作为使用者使用的 Snowflake 账户的账户定位器。
选择用于托管您的使用者账户的云和账户区域。
选择 Add。

提供商：创建和共享 Clean Room¶

在本节中，您将执行以下操作：

创建 Clean Room。
向与协作者共享的 Clean Room 添加数据。
定义联接策略，该策略控制协作者可以在哪些列上加入自己的数据。
定义协作者可以在 Clean Room 中运行哪种类型的分析。
与使用者共享 Clean Room。

开始创建过程¶

要开始创建 Clean Room 的过程，请执行以下操作：

要开始创建 Clean Room 的过程，请执行以下操作：

在左侧导航栏中，选择 Clean Rooms。
在 Clean Rooms 页面上，选择 + Clean Room。
为您的 Clean Room Tutorial 命名。

您将允许协作者在 Clean Room 中进行受众重叠分析。

将数据添加到 Clean Room。¶

要向 Clean Room 添加数据，请执行以下操作：

在 Datasource 部分中，选择 Snowflake。
从 Tables 下拉列表中选择 SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS 表。
选择 Next。

备注

If a table added here is deleted, renamed, moved, or has restrictive permissions added, the table will no longer be usable in the clean room unless you restore the old table at the same location, name, and permissions.

指定联接策略¶

联接策略 指定协作者可以联接数据的哪些列。

要指定联接策略，请执行以下操作：

从 Join Columns 下拉列表中选择以下列：
- HASHED_EMAIL
- HASHED_FIRST_NAME
- HASHED_LAST_NAME
- HASHED_PHONE
协作者只能将他们的数据与这些列联接。
选择 Next。

配置分析模板¶

分析模板 控制协作者如何在 Clean Room 中访问共享数据。协作者只能运行符合模板的分析和查询。

为 Clean Room 协作者选择和配置分析模板：

选择 Audience Overlap & Segmentation 模板。

协作者只能运行您选择的分析。
从 Tables 下拉列表中，选择 DEMO.CUSTOMERS。

协作者只能分析 DEMO.CUSTOMERS 表中的数据。
From the Segmentation & Attribute Columns drop-down list, select the following columns:
- AGE_BAND
- DEVICE_TYPE
- EDUCATION_LEVEL
- STATUS
使用者可以使用这些列筛选和创建分段。
启用 Allow categorical value previews during filtering。
选择 Next。

使用者：登录到 Clean Room UI¶

在本节中，您将从创建和共享 Clean Room 的提供商切换到安装和运行 Clean Room 的使用者。

登录到 Clean Room UI。为将作为使用者的账户提供 Snowflake 账户凭据。

使用者：安装和配置 Clean Room¶

在本节中，您将执行以下操作：

安装通过提供商账户与您共享的 Clean Room。
向 Clean Room 添加数据，以便将其与提供商的数据联接。
添加联接策略以定义使用者数据和提供商数据的关联方式。
定义分析师可用于创建分段、筛选结果和丰富激活数据的列。

开始安装过程¶

要开始安装由提供商账户共享的 Clean Room，请执行以下操作：

在左侧导航栏中，选择 Clean Rooms。
选择 Invited 选项卡。
找到磁贴 Tutorial，然后选择 Join。

将使用者数据添加到 Clean Room¶

要向 Clean Room 添加数据，请执行以下操作：

在 Datasource 部分中，选择 Snowflake。
从 Tables 下拉列表中，选择并保存 SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS_2。
- 如果此表不在您的列表中，请参阅教程简介中的“先决条件”部分，了解安装步骤。
选择 Next。

备注

If a table added here is deleted, renamed, moved, or has restrictive permissions added, the table will no longer be usable in the clean room unless you restore the old table at the same location, name, and permissions.

定义联接策略¶

接下来，指定在此 Clean Room 中的分析或查询中可联接哪些使用者列：

在 Specify Join Policies 窗格的 Join Policies 部分中，选择您的数据中的列（标记为 My Columns）以及提供商表中的等效列（标记为 Collaborator Columns）。
确保使用者表中的列 (My Columns）以及提供商表中的列（Collaborator Columns) 内容匹配（列名不需要匹配）。

例如，使用者的 HASHED_EMAIL 列应与提供商的 HASHED_EMAIL 列联接。所有联接的列必须在您选择的分析中匹配。
选择 Next 以导航到 Configure Analysis & Query 窗格。

定义分段和激活列¶

当您在 Clean Room 安装过程中选择分段和激活列时，您正在定义哪些列可供在 Clean Room 中运行分析的用户使用。分析师可以仅根据这些列创建分段。当您将激活数据发送回提供商时，除非数据来自其中一列，否则分析师无法使用数据丰富分析结果。

要定义分段和激活列，请执行以下操作：

从 Tables 下拉列表中，选择并保存 DEMO.CUSTOMERS_2 表。
From the Segmentation & Attribute Columns drop-down list, select and then save the following columns:
- INCOME_BRACKET
- REGION_CODE
- STATUS
选择 Finish 以安装 Clean Room。

安装需要几分钟才能完成。
每隔几分钟选择一次 Refresh 以检查更改。

当磁贴标签从 Processing 更改为 Run 按钮时，Clean Room 已安装，并且您可以运行分析。

使用者：运行分析¶

在此步骤中，您将在 Clean Room 中运行受众重叠和分段分析。您必须首先选择要在分析中使用的数据。

要配置和运行分析，请执行以下操作：

在 Joined 选项卡，找到 Clean Room 磁贴，然后选择 Run。
Select Audience Overlap & Segmentation » Proceed.
在 My Tables 中，选择 CUSTOMERS。
在 Collaborator's Tables 中，选择 CUSTOMERS。
在 Required Parameters » My Join Columns 中，定义以下联接：
1. 从下拉列表中，选择并保存 HASHED_EMAIL。
2. 选择 + Join Column，然后选择 HASHED_FIRST_NAME 和 HASHED_LAST_NAME。
3. 依次选择 + Join Column、HASHED_PHONE。
当您在 Clean Room 中进行分析时，结果包括以下任何一项属实的记录：
- 使用者的 HASHED_EMAIL 匹配提供商的 HASHED_EMAIL。
- 使用者的 HASHED_FIRST_NAME 匹配提供商的 HASHED_FIRST_NAME，而且使用者的 HASHED_LAST_NAME 匹配提供商的 HASHED_LAST_NAME。
- 使用者的 HASHED_PHONE 匹配提供商的 HASHED_PHONE。
在 User Segmentation 部分，执行以下步骤：
1. 从 My Columns 下拉列表中，选择 INCOME_BRACKET 。
2. 从 Collaborator Columns 下拉列表中，选择 AGE_BAND 。
分析结果按如下分段分组。
在 Filters 部分中，使用下拉列表指定 CUSTOMERS.STATUS = GOLD。

这将分析结果限制为 STATUS = GOLD 的结果。
选择 Run。

您可以选择不同的仓库大小来运行分析，方法是更改 Warehouse 下拉选择。
在 Analyses & Queries 页面中，当分析的状态为 Completed 时：
1. 选择分析以查看结果。
2. 滚动到页面的 Results 部分。您可以切换结果以查看重叠率或非重叠率。
3. 要查看分析的分段组，请选择 Download 并打开以逗号分隔的文件。
继续执行下一步，将丰富的结果激活（发送）到使用者的 Snowflake 账户。

使用者：激活结果¶

在此步骤中，您将分析结果激活到提供商的 Snowflake 账户。这些结果由使用者和提供商表中的数据丰富。

要激活分析结果，请执行以下操作：

在 Results 部分中，选择 Activate。
选择您用于共享 Clean Room 的提供商账户的名称。
在 Segment Name 字段中，指定 My test segment，或此结果集的另一个唯一名称。
从 ID Columns 下拉列表中，选择 HASHED_EMAIL 。
从 Attribute Columns 下拉列表中，选择 Select All 。

当提供商查看分析结果时，匹配的记录将丰富这些列中的其他数据。

可用列与您在安装 Clean Room 时作为使用者选择的分段和激活列相同。
选择 Push Data。

恭喜！现在，您已经在使用者账户中安装并配置了 Clean Room，进行了分析，并将结果推送回提供商账户进行激活。

提供商：查看激活的数据¶

In the previous step you activated to the provider's Snowsight account. Provider activation data is stored in the SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY table of the provider's Snowflake account.

先决条件

使用者首次向您的账户激活数据时，提供商必须在使用者激活数据后约 30 分钟内登录 Clean Room UI。每位使用者账户每个 Clean Room 只需要执行此操作一次。之后，同一使用者在同一 Clean Room 中进行激活无需执行此步骤。要将数据激活到提供商账户，您必须在使用者账户和提供商账户之间创建管道。

完成此先决条件步骤后，您可以使用 Snowsight 或 SQL 查看提供商账户中已激活的数据：

Sign in to Snowsight for the provider account. (Use the Snowflake UI, not the clean room UI.) environment.
In the navigation menu, select Catalog » Database Explorer.
Navigate to SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » PROVIDER_ACTIVATION_SUMMARY.
选择 Data Preview 查看激活数据。

Sign in to Snowsight for the provider account. You are signing in to the Snowflake account, not the clean room environment.
In the navigation menu, select Projects » Worksheets.
Select + SQL Worksheet.
在新工作表中，粘贴并运行以下语句以列出从使用者的 Clean Room 环境推送的激活数据。替换您在 Clean Room UI 中运行激活时输入的分段名称。
```
SELECT *
   FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
   WHERE segment = '<your segment name>';
```
Copy

清理¶

您可以删除为本教程创建的 Clean Room 和激活数据，以清理生产环境。

删除激活数据¶

要从提供商的 Snowflake 账户中删除激活数据，请执行以下操作：

Sign in to Snowsight for the provider account. You are signing in to the Snowflake account, not the clean room environment.
In the navigation menu, select Projects » Worksheets.
Select + SQL Worksheet.
在新工作表中，粘贴并运行以下语句以删除为本教程创建的激活数据。在指定的位置替换您的自定义分段名称：
```
DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
   WHERE segment = '<your segment name>';
```
Copy

删除 Clean Room¶

删除提供商账户中的 Clean Room 会将其从提供商账户和使用者账户中移除。

要删除 Clean Room，请执行以下操作：

登录到 Clean Room UI。
在左侧导航栏中，选择 Clean Rooms。
在 Created 选项卡上，找到 Tutorial 磁贴并选择更多图标 ()。
选择 Delete。
选择 Proceed。

了解详情¶

恭喜！现在，您已使用 Clean Room UI 以提供商的身份创建和共享 Clean Room。您还充当了使用 Clean Room 在保护隐私的环境中分析数据的使用者。

您可以使用以下资源来了解更多信息：

有关一般信息，请参阅关于 Snowflake Data Clean Rooms。
有关 Clean Room UI 的更多信息，请参阅 Clean Room UI 概述。
有关使用开发者 APIs 以编程方式使用 Snowflake Data Clean Room 的信息，请参阅 Snowflake Data Clean Rooms 开发者指南。