Snowflake Data Clean Rooms 環境のインストール¶

アカウントとユーザーの要件¶

Snowflakeアカウントに Snowflake Data Clean Rooms をインストールするための要件は以下のとおりです：

• アカウントは、必要な Snowflake Edition である必要があります。

  • clean roomを作成するには、Enterprise Editionまたはそれ以上が必要です。

  • 他のアカウントで作成されたclean roomに参加して使用 するには、Standard Editionまたはそれ以上が必要です。

• アカウントが キーペア認証 を許可し、それを認証のサービスプロバイダーが使用する必要があります。

• データ共有条件に同意する必要があります。 Snowflakeお客様管理データシェア機能利用規約 に同意されていない場合は、 Snowflake サポート までご連絡ください。Snowflake Data Clean Roomsで使用する リスト は、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 のみ) 多要素認証 (MFA) を、 サポート対象の認証アプリ で使用する必要があります。

これらの要件をすべて満たしておらず、アップグレードが必要な場合は、 Snowflakeサポート までご連絡ください。

インストールの際のユーザー要件¶

clean room環境をインストールするユーザーには、次の要件があります：

• clean room環境をSnowflakeアカウントにインストールするために、 ACCOUNTADMIN ロールがそのアカウントに必要です。

• ACCOUNTADMINロールを持つユーザーは、そのユーザーオブジェクトに有効な姓、名、メールが定義されている必要があります。確認するには、 DESCRIBE USER を実行してください。

1.ネイティブアプリケーションのインストール¶

コードまたはマーケットプレイスからネイティブアプリケーションをインストールします：

マーケットプレイスのプロバイダーおよびコンシューマー規約に同意したくない場合：

Snowflakeアカウントで以下のコードを実行します：

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

Copy

マーケットプレイスのプロバイダーおよびコンシューマー規約に同意する場合：

1. 現在のロールを ACCOUNTADMIN にセットします

2. Snowflake Data Clean Roomsアプリケーション をSnowflake Marketplaceからインストールします。

3. Get を選択し、デフォルトオプションを受け入れます。

インストールには数分かかります。

2.clean room API をインストールする¶

clean room API は、clean roomの作成と使用をプログラムにより行うために使用します。

以下に、clean room API をSnowflakeアカウントにインストールする手順を示します：

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 を実行します。

   • コンシューマーの実行アクセスのみ が許可されたユーザーを追加するには、1つ以上の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のインストールプロセスで使用するため、Snowsight以外の場所に保存してください。

   3. Snowsightの現在のユーザーをサインアウトし、同じSnowflakeアカウントにサインインし直しますが、 サービスユーザーの認証情報 を使用します。

   4. プロファイル を開き、 Resend verification email を選択します。

   5. 確認メールを開き、リンクをクリックしてサービスユーザーのメールアドレスを確認してください。サービスユーザーの認証情報でSnowsightに再度サインインする必要はありません。clean room UI のサービスユーザーの詳細は、 Admin » Snowflake Admin のページの、 Snowflake にあります。

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 を使用できます。