clean roomの作成、参加、削除、およびアンインストール

このページでは、基本的なclean roomを作成する方法、招待されたclean roomに参加する方法、作成したclean roomを削除する方法、コンシューマーとして参加したclean roomを削除する方法を紹介します。

clean roomを新しく作成する

clean roomを作成するには、Snowflakeアカウントに適切な権限が必要です。clean roomの作成者は、 プロバイダー と呼ばれます。

ウェブアプリの Clean Rooms ページでは、プロバイダーとして、クリーンルームの作成と共有を含むクリーンルームのライフサイクルを管理することができます。clean roomのウェブアプリにアクセスできない場合は、Snowflakeアカウントのclean room管理者に問い合わせてください。

clean roomを作成し共有するには、次の手順に従います:

  1. ウェブアプリ でクリーンルーム環境にサインインします。

  2. 左側のナビゲーションで Clean Rooms を選択します。

  3. + Clean Room を選択します。作成するには、以下の手順を実行します:

    1. Add Data を使って、クリーンルームに名前を付け、コンシューマーと共有するテーブルを選択します。名前は最大80文字で、大文字と小文字を区別せず、a-z、0-9、スペース、アンダースコアを使用できます。

    2. Specify Join Policies ステップで、clean roomのアカウント管理者が有効にした ID プロバイダーを有効にし、コンシューマーに参加を許可する列を選択します。

    3. Configure Analysis & Query ステップで、clean roomで使用するテンプレート、テンプレート固有の構成、アクティベーションやプライバシー設定などの追加機能を定義します。

    4. Share Clean Room を使って、コンシューマーをクリーンルームに招き、コラボレーションを行います。また、 Enable Run Analysis & Query オプションを使用して、クリーンルームで分析を実行できるコラボレーターを指定することもできます。

clean room UI で新しいclean roomを作成する手順について詳しい説明を見るには、 clean roomウェブアプリチュートリアル をご利用ください。

注釈

1つのアカウントで作成できる数(clean roomとコラボレーターの合計)には制限があります。テスト用にclean roomを作成しすぎた場合、新しいclean roomを作成するために、clean roomをいくつか削除する必要があるかもしれません。アカウントごとの制限を超えるclean roomが必要な場合は、 Snowflakeサポート までご連絡ください。

clean roomのインストール(参加)

clean roomに招待されたユーザーには、clean room UI でclean roomのインストール、構成、実行に必要なリンクが記載されたメッセージがメールで届きます。リンクをクリックしてclean room UI を使用するか、コードを使用してclean roomをインストールおよび実行することができます。

ウェブアプリの Clean Rooms ページでは、コンシューマーとして、プロバイダーから共有されたクリーンルームをインストールすることができます。clean roomをインストールするには、次の手順に従います:

  1. ウェブアプリ でクリーンルーム環境にサインインします。

  2. 左側のナビゲーションで Clean Rooms を選択します。

  3. Invited タブでクリーンルームを探し、 Join を選択します。clean room UI でコラボレーターとして追加されると、このページに直接移動するリンクを記載した招待メールが届きます。

  4. プロバイダーのデータとのコラボレーションに使用するテーブルを選択し、 Next を選択します。

  5. clean room環境にある ID プロバイダーの中から、この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ウェブアプリを開いた時、表示されなくなります。クリーンルームが削除されたときに分析が進行中である場合、クリーンルームが削除される前に分析が完了しない可能性があります。

作成したclean roomを、clean room UI を使用して削除するには、次を実行します:

  1. ウェブアプリ でクリーンルーム環境にサインインします。

  2. 左側のナビゲーションで Clean Rooms を選択します。

  3. 削除するclean roomで、 その他 (他のオプションを示す3つの垂直の点) > Delete を選択します。

clean roomをアンインストール(参加解除)する

コンシューマーとしてインストール(参加)したクリーンルームをアンインストールすることができます。これにより、アカウント内の全ユーザーのクリーンルームがアンインストールされます。

  1. ウェブアプリ でクリーンルーム環境にサインインします。

  2. 左側のナビゲーションで Clean Rooms を選択します。

  3. Clean Rooms » Joined に移動します。

  4. アンインストールするclean roomで、 その他 (他のオプションを示す3つの垂直の点) > 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管理者に相談してください。