チュートリアル：クリーンルーム UI と2つのアカウントを使用したクリーンルームの作成と実行¶

概要¶

クリーンルームでは、データを使って何ができるかを厳密に管理することでデータのプライバシーを維持しながら、ユーザーがデータをコラボレーターと共有できるようにします。このチュートリアルでは、クリーンルーム UI を使用して2つのテストアカウントで Snowflake Data Clean Room を操作する基本的な流れを説明します。これにより、クリーンルームの全機能が有効になります。クリーンルームがインストールされた単一のSnowflakeアカウントのみにアクセスできる場合は、代わりに、単一アカウントのチュートリアルを試すことができます。

学習内容¶

このチュートリアルでは、次のタスクを実行することで、クリーンルーム UI の使用方法を学びます。

クリーンルーム環境にコラボレーターを追加する。
クリーンルームの作成（データの追加方法、結合ポリシーの指定、コラボレーターがデータに対して実行できる分析タイプの定義、コラボレーターとのクリーンルーム共有など）。
クリーンルームをインストールし、データを追加し、このデータをコラボレーターのデータとどのように結合するかを定義する。
分析を実行する。
分析結果をアクティブ化する。

クリーンルームのコラボレーターについて¶

クリーンルームのコラボレーターはプロバイダーかコンシューマーです。

プロバイダー は、クリーンルームを作成および構成するアカウントです。一般的なクリーンルームでは、プロバイダーは、コンシューマーがクリーンルームで実行できるすべての SQL テンプレートを追加します。プロバイダーはデータを追加し、その使用制限を設定し、コンシューマーを招待して、コンシューマーがクリーンルームに参加してテンプレートを実行できるようにします。
コンシューマー は、クリーンルームに参加するよう招待されたアカウントです。コンシューマーは、プロバイダーが設定した制限に従って、自分のデータを追加し、クリーンルームデータ上でテンプレートを実行します。

前提条件¶

インストール済みのSnowflake Data Clean Rooms UI を使って、2つのSnowflake環境にアクセスできる必要があります。1つはプロバイダーとして、もう1つはコンシューマーとして使用します。環境を自分でインストールするか、または、管理者に Snowflakeアカウント <label-cleanrooms_get_started_add_users> でのクリーンルーム UI に対するアクセスの付与を求める必要があります。
このチュートリアルでは、DEMO_CUSTOMERS_2という名前のサンプルテーブルを使用します。Snowsight でテーブル SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS_2 を検索するか、Snowflakeアカウントで次の SQL コマンドを実行して、このテーブルがインストール済みであることを確認します。
```
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

プロバイダー：クリーンルーム UI にサインインする¶

プロバイダーとしてクリーンルームを作成、構成、共有するクリーンルームにサインインします。

クリーンルームUI へのサインイン。プロバイダーとして機能するアカウントのSnowflakeアカウント認証情報を提供します。

プロバイダー：コンシューマーをコラボレーターとして追加する¶

このセクションでは、このチュートリアルで使用するコンシューマーアカウントをコラボレーターとして追加します。管理者は、他のユーザーがそのコラボレーターとクリーンルームを共有する*前*に、1人の人物をコラボレーターとして定義する必要があります。

コンシューマーをコラボレーターとして追加するには

左側のナビゲーションで Collaborators を選択します。
Snowflake Partners タブを選択します。
+ Snowflake Partner を選択します。
Company Name フィールドに、 Tutorial Consumer を入力します。
Email Address フィールドに、クリーンルームユーザーに関連するメールを入力してください。
Account Locator フィールドに、コンシューマーとして使用しているSnowflakeアカウントのアカウントロケーターを入力します。
コンシューマーアカウントをホストするアカウントのクラウドとリージョンを選択します。
Add を選択します。

プロバイダー：クリーンルームを作成および共有する¶

このセクションでは、以下のことを行います。

クリーンルームを作成します。
コラボレーターと共有されるクリーンルームにデータを追加します。
結合ポリシーを定義します。これにより、コラボレーターが自身のデータと結合できる列を制御します。
コラボレーターがクリーンルームで実行できる分析タイプを定義します。
クリーンルームをコンシューマーと共有します。

作成プロセスの開始¶

クリーンルームを作るプロセスを始めるには：

クリーンルームを作るプロセスを始めるには：

左側のナビゲーションで Clean Rooms を選択します。
Clean Rooms ページで、 + Clean Room を選択します。
クリーンルームに Tutorial という名前を付けます。

クリーンルーム内でコラボレーターがオーディエンスオーバーラップ分析を実施できるようにします。

クリーンルームにデータを追加する¶

クリーンルームにデータを追加するには：

Datasource セクションで、 Snowflake を選択します。
Tables ドロップダウンリストから、SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS テーブルを選択します。
Next を選択します。

結合ポリシーの指定¶

結合ポリシー は、コラボレーターが結合できるデータ列を指定します。

参加ポリシーを指定するには：

Join Columns ドロップダウンリストから、以下の列を選択します。
- HASHED_EMAIL
- HASHED_FIRST_NAME
- HASHED_LAST_NAME
- HASHED_PHONE
コラボレーターはこれらの列のみでデータを結合することができます。
Next を選択します。

分析テンプレートの構成¶

分析テンプレート は、クリーンルームで共有されたデータにコラボレーターがどのようにアクセスできるかを制御します。コラボレーターは、テンプレートに準拠した分析やクエリのみを実行できます。

クリーンルームのコラボレーター用に分析テンプレートを選択し、構成します。

Audience Overlap & Segmentation テンプレートを選択します。

コラボレーターは、ここで選択した分析のみを実行できるように制限されます。
Tables ドロップダウンリストから、DEMO.CUSTOMERS を選択します。

コラボレーターが分析できるのは、DEMO.CUSTOMERS テーブルのデータのみです。
Segmentation & Activation Columns ドロップダウンリストから、以下の列を選択します。
- AGE_BAND
- DEVICE_TYPE
- EDUCATION_LEVEL
- STATUS
コンシューマーはこれらの列を使用してセグメントをフィルタリングし、作成することができます。
Allow categorical value previews during filtering を有効にします。
Next を選択します。

コンシューマー：クリーンルーム UI にサインインする¶

このセクションでは、クリーンルームを作成し共有するプロバイダーの立場から、クリーンルームをインストールして実行するコンシューマーとしての作業に切り替えます。

クリーンルームUI へのサインイン。コンシューマーとして作業するアカウントのSnowflakeアカウント認証情報を提供します。

コンシューマー：クリーンルームをインストールして構成する¶

このセクションでは、次のアクションを実行します。

プロバイダーアカウントから共有されたクリーンルームをインストールします。
クリーンルームにデータを追加し、プロバイダーのデータと結合できるようにします。
コンシューマデータとプロバイダーデータの関連性を定義する結合ポリシーを追加します。
アナリストがセグメントを作成し、結果をフィルタリングし、アクティブ化データを強化させるために使用できる列を定義します。

インストールプロセスを開始する¶

プロバイダーアカウントで共有されているクリーンルームのインストールを開始します。

左側のナビゲーションで Clean Rooms を選択します。
Invited タブを選択します。
Tutorial タイルを見つけ、 Join を選択します。

クリーンルームにコンシューマーデータを追加する¶

クリーンルームにデータを追加するには：

Datasource セクションで、 Snowflake を選択します。
Tables ドロップダウンリストで、SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS_2を選択してから保存します。
- このテーブルがリストにない場合は、チュートリアルの概要にある前提条件セクションを参照して、インストール方法を確認してください。
Next を選択します。

結合ポリシーの定義¶

次に、このクリーンルームの分析またはクエリで結合可能なコンシューマー列を指定します。

Specify Join Policies ペインの、Join Policies セクションで、自分のデータの列（My Columns のラベル）と、プロバイダーのテーブルにある同等の列（Collaborator Columns のラベル）を選択します。
コンシューマーのテーブルの列（My Columns）とプロバイダーのテーブルの列（Collaborator Columns）のコンテンツが一致していることを確認します（列名が一致する必要はありません）。

例えば、コンシューマーの HASHED_EMAIL 列はプロバイダーの HASHED_EMAIL 列と結合する必要があります。結合された列はすべて、選択した分析が一致する必要があります。
Next を選択して、Configure Analysis & Query ペインに移動します。

セグメンテーションとアクティブ化列の定義¶

クリーンルームのインストールプロセスでセグメンテーション列とアクティベーション列を選択すると、ユーザーがクリーンルームで分析の実行に利用できる列が定義されます。アナリストはこれらの列のみに基づいてセグメントを作成できます。アクティベーションデータをプロバイダーに送り返す際、アナリストはこれらの列のいずれかに由来するデータでない限り、分析結果の強化に使用できません。

セグメンテーションとアクティブ化列を定義するには：

Tables ドロップダウンリストで、DEMO.CUSTOMERS_2テーブルを選択してから保存します。
Segmentation & Activation Columns ドロップダウンリストで、以下の列を選択してから保存します。
- INCOME_BRACKET
- REGION_CODE
- STATUS
Finish を選択してクリーンルームをインストールします。

インストールが完了するまでに数分かかります。
数分ごとに Refresh を選択して変更をチェックします。

タイルのラベルが Processing から Run ボタンに変わると、クリーンルームがインストールされ、分析を実行できます。

コンシューマー：分析を実行する¶

このステップでは、クリーンルームでオーディエンスのオーバーラップおよびセグメンテーション分析を実行します。まず、分析で使用するデータを選択する必要があります。

分析を構成および実行するには：

Joined タブで、クリーンルームのタイルを探し、Run を選択します。
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 を選択します。
クリーンルームで分析を実行すると、以下の項目のいずれかに当てはまる記録が結果に含まれます。
- コンシューマーの 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 を選択します。
クリーンルームの共有に使用したプロバイダーアカウント名を選択します。
Segment Name フィールドで、My test segment またはこの結果セットの別の一意の名前を指定します。
ID Columns ドロップダウンリストから、 HASHED_EMAIL を選択します。
Attribute Columns ドロップダウンリストから、 Select All を選択します。

プロバイダーが分析結果を見るとき、一致した記録はこれらの列で見つかった追加データで強化されます。

利用可能な列は、クリーンルームをインストールしたときにコンシューマーとして選択したセグメンテーション列およびアクティベーション列と同じです。
Push Data を選択します。

おめでとうございます。これで、コンシューマーアカウントにクリーンルームをインストールして設定し、分析を実行し、プロバイダーアカウントに結果をプッシュバックしてアクティブ化が行われました。

プロバイダー：アクティブ化されたデータを表示する¶

前のステップでは、プロバイダーのSnowsightアカウントにアクティブ化しました。コンシューマーのアクティベーションデータは、プロバイダーのSnowflakeアカウントの SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY テーブルに保存されます。

前提条件

コンシューマーがプロバイダーのアカウントに初めてデータをアクティブ化するとき、プロバイダーは、コンシューマーがデータをアクティブ化した後の約30分間、クリーンルーム UI にサインインしている必要があります。これは、コンシューマーアカウントごとに、クリーンルームごとに1回のみ必要です。同じクリーンルームの同じコンシューマーによる後続のアクティブ化では、このステップは必要ありません。プロバイダーのアカウントにデータをアクティブ化するには、コンシューマーアカウントとプロバイダーアカウントの間にパイプラインを作成する必要があります。

この前提条件のステップが完了すると、Snowsightまたは SQL を使用して、プロバイダーアカウントでアクティブ化されたデータを表示できます。

プロバイダーアカウントの Snowsight にサインインします。（クリーンルーム UI ではなく、Snowflake UI を使用します。）
ナビゲーションメニューで Catalog » Database Explorer を選択します。
SAMOOHA_BY_SNOWFLAKE_LOCAL_DB » PUBLIC » Tables » PROVIDER_ACTIVATION_SUMMARY に移動します。
アクティブ化データを表示するには、 Data Preview を選択します。

プロバイダーアカウントの Snowsight にサインインします。クリーンルーム環境ではなく、Snowflakeアカウントにサインインしています。
ナビゲーションメニューで Projects » Worksheets を選択します。
+ SQL Worksheet を選択します。
新しいワークシートに以下のステートメントを貼り付けて実行し、コンシューマーのクリーンルーム環境からプッシュされたアクティベーションデータをリストします。クリーンルーム UI でアクティベーションを実行したときに入力したセグメント名は置き換えます。
```
SELECT *
   FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
   WHERE segment = '<your segment name>';
```
Copy

クリーンアップする¶

このチュートリアルのために作成したクリーンルームとアクティブ化データを削除して、本番環境をクリーンアップすることができます。

アクティブ化データの削除¶

プロバイダーのSnowflakeアカウントからアクティブ化データを削除するには：

プロバイダーアカウントの Snowsight にサインインします。クリーンルーム環境ではなく、Snowflakeアカウントにサインインしています。
ナビゲーションメニューで Projects » Worksheets を選択します。
+ SQL Worksheet を選択します。
新しいワークシートに次のステートメントを貼り付けて実行し、このチュートリアル用に作成したアクティベーションデータを削除します。示されている場所にあるカスタムセグメント名は置き換えます。
```
DELETE FROM SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.PUBLIC.PROVIDER_ACTIVATION_SUMMARY
   WHERE segment = '<your segment name>';
```
Copy

クリーンルームの削除¶

プロバイダーアカウントでクリーンルームを削除すると、プロバイダーアカウントとコンシューマーアカウントの両方から削除されます。

クリーンルームを削除するには：

クリーンルームUI へのサインイン。
左側のナビゲーションで Clean Rooms を選択します。
Created タブで Tutorial タイルを見つけ、その他アイコン（）を選択します。
Delete を選択します。
Proceed を選択します。

詳細¶

おめでとうございます。これで、プロバイダーとしてクリーンルームを作成し、共有するためのクリーンルームUIを使用することができました。あなたはまた、プライバシーが守られた環境でデータを分析するためにクリーンルームを利用するコンシューマーでもあります。

詳しくは以下のリソースを使用できます。

一般的な情報については、 Snowflake Data Clean Rooms についてをご参照ください。
クリーンルームUIの詳細については、クリーンルーム UI の概要をご参照ください。
デベロッパー APIs を使ってプログラム的に Snowflake Data Clean Room を操作する方法については、 Snowflake Data Clean Rooms 開発者ガイドをご参照ください。